home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / os2bbs / ps2_201e.zip / PALMSCAN.DOC < prev    next >
Text File  |  1996-01-07  |  172KB  |  5,320 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                   PalmScan v2.01
  30.  
  31.  
  32.                      The Ultimate Archive Conversion Utility
  33.  
  34.  
  35.                                     User guide
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                   PalmScan v2.01
  64.  
  65.  
  66.                      The Ultimate Archive Conversion Utility
  67.  
  68.  
  69.                                  January 7, 1996
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.               Software and documentation written by Steven Hendriks
  91.  
  92.                      Copyright (C) 1993,96 by Steven Hendriks
  93.  
  94.                                All rights reserved.
  95.  
  96.  
  97.                      All information in this documentation is
  98.                       subject to change without prior notice
  99.       PalmScan v2.01                                             User guide
  100.       ---------------------------------------------------------------------
  101.  
  102.       Table of Contents
  103.  
  104.  
  105.       1  Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  106.          1.1  Copyright and License Agreement . . . . . . . . . . . . . . 6
  107.          1.2  Contacting the author . . . . . . . . . . . . . . . . . . . 7
  108.          1.3  What is PalmScan  . . . . . . . . . . . . . . . . . . . . . 7
  109.          1.4  Features  . . . . . . . . . . . . . . . . . . . . . . . . . 8
  110.          1.5  System requirements . . . . . . . . . . . . . . . . . . .  10
  111.          1.6  Logging . . . . . . . . . . . . . . . . . . . . . . . . .  10
  112.          1.7  The distribution package  . . . . . . . . . . . . . . . .  11
  113.          1.8  Runtime . . . . . . . . . . . . . . . . . . . . . . . . .  11
  114.          1.9  Extended Wildcards  . . . . . . . . . . . . . . . . . . .  12
  115.  
  116.       2  Installation . . . . . . . . . . . . . . . . . . . . . . . . .  13
  117.          2.1  First time installation . . . . . . . . . . . . . . . . .  13
  118.               2.2.1  Installing PalmScan in FileDoor  . . . . . . . . .  13
  119.               2.2.2  Installing PalmScan in SuperBBS  . . . . . . . . .  13
  120.               2.2.3  Installing PalmScan in Allfix  . . . . . . . . . .  14
  121.               2.2.4  Installing PalmScan in RemoteAccess 2.xx . . . . .  14
  122.               2.2.5  Installing PalmScan in RAFT  . . . . . . . . . . .  14
  123.               2.2.6  Installing PalmScan in Maximus . . . . . . . . . .  15
  124.               2.2.7  Installing PalmScan in Ezycom  . . . . . . . . . .  16
  125.               2.2.8  Installing PalmScan in Concord . . . . . . . . . .  17
  126.               2.2.9  Installing PalmScan in ProBoard  . . . . . . . . .  17
  127.          2.3  Commandline . . . . . . . . . . . . . . . . . . . . . . .  18
  128.          2.4  Watchdog, CTTY, ANSI.SYS  . . . . . . . . . . . . . . . .  24
  129.          2.5  Errorlevels . . . . . . . . . . . . . . . . . . . . . . .  24
  130.  
  131.       3  The configuration  . . . . . . . . . . . . . . . . . . . . . .  25
  132.          3.1  PALMSCAN.CFG  . . . . . . . . . . . . . . . . . . . . . .  25
  133.          3.2  PSetup  . . . . . . . . . . . . . . . . . . . . . . . . .  26
  134.               3.2.1  Commandline  . . . . . . . . . . . . . . . . . . .  26
  135.               3.2.2  Starting PSetup  . . . . . . . . . . . . . . . . .  26
  136.               3.2.3  Keys . . . . . . . . . . . . . . . . . . . . . . .  26
  137.          3.3  System data . . . . . . . . . . . . . . . . . . . . . . .  27
  138.               3.3.1  Site Information . . . . . . . . . . . . . . . . .  27
  139.                      BBS name . . . . . . . . . . . . . . . . . . . . .  27
  140.                      SysOp name . . . . . . . . . . . . . . . . . . . .  27
  141.                      Key number . . . . . . . . . . . . . . . . . . . .  27
  142.               3.3.2  Screen settings  . . . . . . . . . . . . . . . . .  28
  143.                      Redirect screen output of external programs  . . .  28
  144.                      Normal color . . . . . . . . . . . . . . . . . . .  28
  145.                      Highlighted color  . . . . . . . . . . . . . . . .  28
  146.                      Background color . . . . . . . . . . . . . . . . .  29
  147.               3.3.3  Pathnames  . . . . . . . . . . . . . . . . . . . .  30
  148.                      Temporary directory  . . . . . . . . . . . . . . .  30
  149.                      Bad files directory  . . . . . . . . . . . . . . .  30
  150.                      Infected files directory . . . . . . . . . . . . .  30
  151.                      Hacked files directory . . . . . . . . . . . . . .  31
  152.                      Old files directory  . . . . . . . . . . . . . . .  31
  153.                      Bad GIF files directory  . . . . . . . . . . . . .  31
  154.                      Substitute drive . . . . . . . . . . . . . . . . .  32
  155.               3.3.4  Files Lists  . . . . . . . . . . . . . . . . . . .  33
  156.                      Hacked files list  . . . . . . . . . . . . . . . .  33
  157.                      Skip files list  . . . . . . . . . . . . . . . . .  33
  158.                      Pack Unpacked files list . . . . . . . . . . . . .  33
  159.                      Remove files list  . . . . . . . . . . . . . . . .  34
  160.                      Add files list . . . . . . . . . . . . . . . . . .  34
  161.               3.3.5  Message System . . . . . . . . . . . . . . . . . .  35
  162.       PalmScan v2.01                                             User guide
  163.       ---------------------------------------------------------------------
  164.  
  165.                      Net address  . . . . . . . . . . . . . . . . . . .  35
  166.                      Messagebase path . . . . . . . . . . . . . . . . .  35
  167.                      Messagebase format . . . . . . . . . . . . . . . .  36
  168.                      Message area number  . . . . . . . . . . . . . . .  36
  169.                      MessageArea configuration keyword  . . . . . . . .  37
  170.               3.3.6  File-database  . . . . . . . . . . . . . . . . . .  38
  171.                      File-database  . . . . . . . . . . . . . . . . . .  38
  172.                      Uploader name  . . . . . . . . . . . . . . . . . .  39
  173.                      BBS system directory . . . . . . . . . . . . . . .  39
  174.                      Update FILES.BBS   . . . . . . . . . . . . . . . .  40
  175.                      Extended descriptions character  . . . . . . . . .  40
  176.                      Spaces to indent . . . . . . . . . . . . . . . . .  41
  177.                      Download counters  . . . . . . . . . . . . . . . .  41
  178.                      FILES.BBS Filename . . . . . . . . . . . . . . . .  42
  179.                      Online Import  . . . . . . . . . . . . . . . . . .  42
  180.               3.3.7  Miscellaneous  . . . . . . . . . . . . . . . . . .  43
  181.                      Log file . . . . . . . . . . . . . . . . . . . . .  43
  182.                      Log style  . . . . . . . . . . . . . . . . . . . .  43
  183.                      No disk space check  . . . . . . . . . . . . . . .  44
  184.                      Exec timeout . . . . . . . . . . . . . . . . . . .  44
  185.          3.4  File Processing . . . . . . . . . . . . . . . . . . . . .  45
  186.               3.4.1  General settings . . . . . . . . . . . . . . . . .  45
  187.                      Only process new files . . . . . . . . . . . . . .  45
  188.                      Only process listed files  . . . . . . . . . . . .  46
  189.                      Process embedded archives  . . . . . . . . . . . .  46
  190.                      New archive date . . . . . . . . . . . . . . . . .  47
  191.               3.4.2  Archive Conversion . . . . . . . . . . . . . . . .  48
  192.                      Archive conversion . . . . . . . . . . . . . . . .  48
  193.                      SFX  . . . . . . . . . . . . . . . . . . . . . . .  48
  194.                      Only Main Archives . . . . . . . . . . . . . . . .  48
  195.                      Don't convert secure archives  . . . . . . . . . .  49
  196.                      Only convert embedded archives with normal extensions
  197.                             . . . . . . . . . . . . . . . . . . . . . .  49
  198.                      ArchiveConversion configuration keyword  . . . . .  50
  199.                      Convert ALL archives . . . . . . . . . . . . . . .  50
  200.               3.4.3  Self-Extracting Archives . . . . . . . . . . . . .  51
  201.                      Process SFX archives . . . . . . . . . . . . . . .  51
  202.                      Do not convert self-extracting archives  . . . . .  51
  203.                      Process UC2 self-extracting archives . . . . . . .  51
  204.                      UC2 SFX commandline options  . . . . . . . . . . .  52
  205.                      Only process sealed UC2 self-extracting archives .  52
  206.                      UC2SFX configuration keyword . . . . . . . . . . .  52
  207.                      UC2 SFX seal test command  . . . . . . . . . . . .  53
  208.                      Scan SFX archives for viruses  . . . . . . . . . .  53
  209.               3.4.4  Archive Headers  . . . . . . . . . . . . . . . . .  54
  210.                      Archive header file  . . . . . . . . . . . . . . .  54
  211.                      Alternative header file  . . . . . . . . . . . . .  54
  212.                      Put FILE_ID description in archive header  . . . .  55
  213.                      No title in headers  . . . . . . . . . . . . . . .  55
  214.               3.4.5  Descriptions . . . . . . . . . . . . . . . . . . .  56
  215.                      Import FILE_ID description . . . . . . . . . . . .  56
  216.                      One line FILE_ID . . . . . . . . . . . . . . . . .  56
  217.                      Filter high ASCII  . . . . . . . . . . . . . . . .  56
  218.                      Filter control codes . . . . . . . . . . . . . . .  57
  219.                      Filter drawings  . . . . . . . . . . . . . . . . .  57
  220.                      Maximum Width  . . . . . . . . . . . . . . . . . .  57
  221.                      Maximum Length . . . . . . . . . . . . . . . . . .  58
  222.                      FileID configuration keyword . . . . . . . . . . .  58
  223.                      Describe MOD's . . . . . . . . . . . . . . . . . .  59
  224.          3.5  Archivers . . . . . . . . . . . . . . . . . . . . . . . .  60
  225.       PalmScan v2.01                                             User guide
  226.       ---------------------------------------------------------------------
  227.  
  228.               3.5.1  Archiver commands  . . . . . . . . . . . . . . . .  60
  229.                      Compression  . . . . . . . . . . . . . . . . . . .  61
  230.                      Decompression  . . . . . . . . . . . . . . . . . .  61
  231.                      Add Header . . . . . . . . . . . . . . . . . . . .  62
  232.                      Alternative header . . . . . . . . . . . . . . . .  62
  233.                      Test . . . . . . . . . . . . . . . . . . . . . . .  63
  234.                      Multi-Volume Compression . . . . . . . . . . . . .  63
  235.                      Multi-Volume Decompression . . . . . . . . . . . .  64
  236.                      Example archiver commands  . . . . . . . . . . . .  64
  237.               3.5.2  Archive Protection . . . . . . . . . . . . . . . .  66
  238.                      UC2 protection . . . . . . . . . . . . . . . . . .  66
  239.                      RAR lock . . . . . . . . . . . . . . . . . . . . .  66
  240.          3.6  Virus scan  . . . . . . . . . . . . . . . . . . . . . . .  67
  241.               3.6.1  Files to scan  . . . . . . . . . . . . . . . . . .  67
  242.               3.6.2  Virus scanners . . . . . . . . . . . . . . . . . .  67
  243.                      Scanner name . . . . . . . . . . . . . . . . . . .  67
  244.                      Command  . . . . . . . . . . . . . . . . . . . . .  68
  245.                      Low Errorlevel . . . . . . . . . . . . . . . . . .  68
  246.                      High Errorlevel  . . . . . . . . . . . . . . . . .  69
  247.                      Other Errorlevel . . . . . . . . . . . . . . . . .  69
  248.                      File specifications  . . . . . . . . . . . . . . .  69
  249.                      Scanner configuration keyword  . . . . . . . . . .  70
  250.               3.6.3  Options  . . . . . . . . . . . . . . . . . . . . .  71
  251.                      Complete scan  . . . . . . . . . . . . . . . . . .  71
  252.                      Fast scan  . . . . . . . . . . . . . . . . . . . .  71
  253.          3.7  Hacked Files  . . . . . . . . . . . . . . . . . . . . . .  72
  254.          3.8  Skip Files  . . . . . . . . . . . . . . . . . . . . . . .  72
  255.          3.9  Pack Unpacked . . . . . . . . . . . . . . . . . . . . . .  73
  256.               File specifications . . . . . . . . . . . . . . . . . . .  73
  257.               Minimum size  . . . . . . . . . . . . . . . . . . . . . .  73
  258.          3.10 Remove Files  . . . . . . . . . . . . . . . . . . . . . .  74
  259.          3.11 Add Files . . . . . . . . . . . . . . . . . . . . . . . .  75
  260.               Add CRC file list . . . . . . . . . . . . . . . . . . . .  75
  261.          3.12 GIF settings  . . . . . . . . . . . . . . . . . . . . . .  76
  262.               Add GIF specifications to descriptions  . . . . . . . . .  76
  263.               GIF pack  . . . . . . . . . . . . . . . . . . . . . . . .  77
  264.               Do not convert embedded graphics files. . . . . . . . . .  77
  265.               JFIF unpack . . . . . . . . . . . . . . . . . . . . . . .  78
  266.               JPEG unpack . . . . . . . . . . . . . . . . . . . . . . .  78
  267.               GIFblast unpack . . . . . . . . . . . . . . . . . . . . .  78
  268.               Repack JFIF files . . . . . . . . . . . . . . . . . . . .  79
  269.               Repack JPEG files . . . . . . . . . . . . . . . . . . . .  79
  270.               Repack GIFblast files . . . . . . . . . . . . . . . . . .  79
  271.               Minimum resolution  . . . . . . . . . . . . . . . . . . .  80
  272.               GIF test command / failures . . . . . . . . . . . . . . .  80
  273.          3.13 Old files . . . . . . . . . . . . . . . . . . . . . . . .  81
  274.          3.14 Include Configurations  . . . . . . . . . . . . . . . . .  82
  275.  
  276.       4  Registration . . . . . . . . . . . . . . . . . . . . . . . . .  83
  277.  
  278.       5  Credits  . . . . . . . . . . . . . . . . . . . . . . . . . . .  84
  279.  
  280.       I  Index  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  85
  281.       PalmScan v2.01                                             User guide
  282.       ---------------------------------------------------------------------
  283.  
  284.       1  Introduction
  285.       ---------------
  286.  
  287.       1.1  Copyright and License Agreement
  288.       ------------------------------------
  289.  
  290.       'PalmScan' refers to all executables and documentation as distributed
  291.       in the compressed file in which the package was released.
  292.  
  293.       Users of PalmScan must accept this disclaimer of warranty:
  294.  
  295.       -    PalmScan is copyrighted material by Steven Hendriks. It may only
  296.            be used in agreement with the conditions set out in this license
  297.            agreement.
  298.  
  299.       -    PalmScan is released as shareware.
  300.  
  301.       -    You may use PalmScan for an evaluation period of one month.
  302.            After this period you MUST either register PalmScan or stop
  303.            using it.
  304.  
  305.       -    Registration is REQUIRED for commercial usage (in a commercial
  306.            environment, such as business, governmental organization,
  307.            association, school, foundation, or any other form of juridical
  308.            person, or any system where PalmScan is directly or indirectly
  309.            used to make profit).
  310.  
  311.       -    The evaluation version of PalmScan may be distributed freely
  312.            provided no money or any other compensation is asked or accepted
  313.            without prior written permission from the author.
  314.  
  315.       -    PalmScan is supplied as is, without warranty or guarantee of any
  316.            kind, either expressed or implied, as to the fitness for a
  317.            particular purpose or quality or performance of this program,
  318.            except that PalmScan will occupy some disk space.
  319.  
  320.       -    In no event shall Steven Hendriks be liable to you or anyone
  321.            else for any damages or cost, including, but not limited to, any
  322.            lost profits, lost savings or lost income which may result from
  323.            the use or inability to use PalmScan.
  324.  
  325.       -    In no way is Steven Hendriks obligated to you or anyone else to
  326.            provide future versions of, or support for PalmScan.
  327.  
  328.       -    Steven Hendriks reserves the right not to release future
  329.            shareware versions of PalmScan, but switch to a commercial
  330.            marketing concept instead.
  331.  
  332.       -    It is forbidden to modify, adapt, translate, reverse engineer,
  333.            decompile and/or disassemble the software in this package.
  334.            Patching the medium at places that carry the software
  335.            (including, but not limited to, RAM memory and physical media)
  336.            is seen as a program change and is also forbidden.
  337.  
  338.       -    Your use of PalmScan constitutes your agreement to this license
  339.            and disclaimer and your release of the author from any form of
  340.            liability or litigation.
  341.  
  342.  
  343.                                       - 6 -
  344.       PalmScan v2.01                                             User guide
  345.       ---------------------------------------------------------------------
  346.  
  347.       1.2  Contacting the author
  348.       --------------------------
  349.  
  350.       If you have any questions about PalmScan, problems with it, or if you
  351.       wish to contact the author for suggestions etcetera, you can:
  352.  
  353.       -    Call Oasis BBS (300 - 28800 bps) at +31-181-453132
  354.  
  355.       -    Send a NetMail message to Steven Hendriks at:
  356.            Fidonet         2:2802/140
  357.            VirNet             9:310/1
  358.            SIGnet         27:1331/401
  359.            OASE            200:3110/0
  360.  
  361.       -    Send E-Mail tm:
  362.            0340278@ptfe22.hro.nl
  363.  
  364.       -    Send an echomail message in the OASISSOFT support echo.
  365.  
  366.       -    Send an echomail message in an appropriate area in one of the
  367.            above networks (I cannot read _all_ areas, especially not all
  368.            Fidonet areas, use netmail if you are not sure whether I'm
  369.            reading an area or not).
  370.  
  371.       -    Send a letter to this address:
  372.            Steven Hendriks
  373.            Hoofd 22
  374.            3214AH Zuidland
  375.            the Netherlands
  376.  
  377.  
  378.       1.3  What is PalmScan
  379.       ---------------------
  380.  
  381.       PalmScan is the conversion utility to convert almost any archive to
  382.       another format. It can check for viruses inside the archives while
  383.       converting (with up to 20 virus scanners), get file descriptions,
  384.       process embedded archives, remove/add files from/to archives, full
  385.       support for GIF packing, and lots more! PalmScan has full FileDoor,
  386.       FILES.BBS and RemoteAccess, Ezycom and Concord file-database support,
  387.       works with any door.sys or dorinfo supporting bbs system, works great
  388.       in Allfix and many othep programs, or stand-alone!
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.                                       - 7 -
  407.       PalmScan v2.01                                             User guide
  408.       ---------------------------------------------------------------------
  409.  
  410.       1.4  Features
  411.       -------------
  412.  
  413.       -    A very flexible configuration. You can configure almost anything
  414.            the way you want it.
  415.  
  416.       -    Detects these archive types:
  417.  
  418.            - ARC
  419.            - PAK *
  420.            - ZIP * ~
  421.            - LZH *
  422.            - ZOO
  423.            - SQZ *
  424.            - HYP
  425.            - ARJ * ~ @
  426.            - HAP
  427.            - UC2 * ~
  428.            - RAR * ~ @
  429.  
  430.            * Self-extracting archives are detected.
  431.            ~ Security envelopes / authenticity validations / seals are
  432.              detected.
  433.            @ Multi-volume archives are supported.
  434.  
  435.            PalmScan can detect other archives by looking at the archive
  436.            extension. Other archivers could be added, just send the
  437.            archiving program to the author and support will be added, if
  438.            possible.
  439.  
  440.       -    Supports up to 30 different archive types.
  441.  
  442.       -    Supports GIF, PNG, JFIF, JPEG and GIFblast graphics images.
  443.  
  444.       -    Full support for these file-databases:
  445.  
  446.            - RemoteAccess (both 2.0x and 2.5x)
  447.            - Ezycom (both 1.02 and 1.10)
  448.            - Concord
  449.  
  450.       -    Full support for online features in Concord, Ezycom and
  451.            Filedoor.
  452.  
  453.       -    Special FILES.BBS support.
  454.  
  455.       -    Full support for the RemoteAccess 2.0x, RemoteAccess 2.5x,
  456.            Ezycom 1.02, Ezycom 1.10 and Concord file-databases, including
  457.            an advanced maintenance feature.
  458.  
  459.       -    Virus scanning with up to 20 virus scanners.
  460.  
  461.       -    Checking files in a hacklist.
  462.  
  463.       -    Reject files which are too old.
  464.  
  465.       -    Compress un-archived files with your favourite archiver.
  466.  
  467.       -    Get file descriptions from FILE_ID.DIZ and DESC.SDI.
  468.  
  469.                                       - 8 -
  470.       PalmScan v2.01                                             User guide
  471.       ---------------------------------------------------------------------
  472.  
  473.       -    Describes music files, like MOD, ScreamTracker, organ files,
  474.            etc.
  475.  
  476.       -    Describes Compuserve GIF pictures, portable network graphics
  477.            (PNG), JFIF and JPEG graphics.
  478.  
  479.       -    Tests GIF pictures.
  480.  
  481.       -    Ability to notify the system operator about infected, bad,
  482.            hacked and old archives and bad GIF files. PalmScan supports
  483.            Fido (*.msg), Hudson, Squish, Ezycom (both 1.02 and 1.10) and
  484.            JAM messagebases.
  485.  
  486.       -    Add and remove files to/from archives.
  487.  
  488.       -    Add file list with CRC-32's.
  489.  
  490.       -    Writes a complete log file.
  491.  
  492.       -    Runs under any BBS system which supports the DOOR.SYS or
  493.            DORINFO.DEF dropfile format. Without one of these dropfiles,
  494.            PalmScan can be run in local-only mode.
  495.  
  496.       -    Supports both ANSI and ASCII when running in online mode.
  497.  
  498.       -    Built-in Fossil support and carrier detection.
  499.  
  500.       -    Very user-friendly; virtually anything can be configured.
  501.  
  502.       -    A very easy-to-use setup program is included.
  503.  
  504.       -    High quality performance, very low registration fee.
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                       - 9 -
  533.       PalmScan v2.01                                             User guide
  534.       ---------------------------------------------------------------------
  535.  
  536.       1.5  System requirements
  537.       ------------------------
  538.  
  539.       DOS version:
  540.  
  541.       -    IBM PC, XT, AT or compatible.
  542.  
  543.       -    IBM PC-DOS / Microsoft MS-DOS 3.0 (or compatible), or higher.
  544.  
  545.       -    At least 20 file handles ('FILES=20' in your CONFIG.SYS). A
  546.            lower value can cause 'Out of file handles' errors.
  547.  
  548.       -    At least 350 KB conventional memory available.
  549.  
  550.       -    At least one of the following compression utilities:
  551.            PKARC, PKZIP, LZH, ZOO, SQZ, Hyper, ARJ, HAP, PAK, UC2, RAR.
  552.  
  553.       -    A disk cache can improve performance, but is not required. If
  554.            you are not using a disk cache, make sure that the number of DOS
  555.            buffers is at least 30 ('BUFFERS=30' in your CONFIG.SYS) to
  556.            improve performance.
  557.  
  558.  
  559.       OS/2 version:
  560.  
  561.       -    OS/2 2.1 or higher.
  562.  
  563.  
  564.       1.6  Logging
  565.       ------------
  566.  
  567.       PalmScan can keep track of its activity in a log file. When no
  568.       filename is given in the configuration, logging is turned off.
  569.  
  570.       The following characters are used in the log, to make things a bit
  571.       clearer:
  572.  
  573.       !  : Fatal error
  574.       ?  : Other (non-fatal) error or an infected/hacked/bad archive has
  575.            been found
  576.       $  : User information
  577.       #  : Other information
  578.       +  : Statistics
  579.       ·  : Debug information
  580.       ■  : Debug information, external programs execution
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                                       - 10 -
  596.       PalmScan v2.01                                             User guide
  597.       ---------------------------------------------------------------------
  598.  
  599.       1.7  The distribution package
  600.       -----------------------------
  601.  
  602.       PalmScan is distributed in a self-extracting RAR archive. The
  603.       original distribution archive, and all embedded archives, contain an
  604.       authenticity validation. If you obtained a version without this
  605.       authenticity validation, please check with one of the registration
  606.       sites for the original distribution archive.
  607.  
  608.  
  609.       When unpacking the archive, it should show:
  610.  
  611.        Verifying authenticity information ...  Ok
  612.  
  613.       and:
  614.  
  615.        modified at (time)  07 Jan 1996
  616.        by Steven Hendriks
  617.  
  618.  
  619.       This package includes:
  620.  
  621.       PALMSCAN.EXE   The main program
  622.       PALMSCAN.OVR   Overlay file for the message system (DOS version only)
  623.       PALMSCAN.DOC   This documentation
  624.       PALMSCAN.HLP   Commandline help
  625.       PSETUP.EXE     PalmScan SETUP program
  626.       PSREG.EXE      Self-extracting archive containing the registration
  627.                      forms
  628.       EXAMPLE.EXE    Self-extracting archive containing an example
  629.                      configuration file
  630.       PALMSCAN.ANS   Ansi advertisement
  631.       FILE_ID.DIZ    Package description
  632.       UPDATE.LOG     Update log
  633.       README.1ST     Last-minute information
  634.       PUPDATE.EXE    Program to update PalmScan v1.xx configuration to
  635.                      v2.01.
  636.  
  637.  
  638.       1.8  Runtime
  639.       ------------
  640.  
  641.       While PalmScan is running, no user input is required.
  642.       To abort processing of files, you can press escape. PalmScan will
  643.       then finish the file which is currently being processed, and after
  644.       that ask whether you wish to continue processing or not.
  645.  
  646.       PalmScan displays a spinning cursor when it's working. In the DOS
  647.       version, this will not be shown when an external program is being
  648.       executed. In the OS/2 version, it will always be shown when the
  649.       output of external programs is redirected to NUL (RedirectOutput
  650.       configuration keyword).
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                                       - 11 -
  659.       PalmScan v2.01                                             User guide
  660.       ---------------------------------------------------------------------
  661.  
  662.       1.9  Extended Wildcards
  663.       -----------------------
  664.  
  665.       PalmScan has support for extended wildcards. This means that any
  666.       number of '?' and '*' characters can be used in file-specifications
  667.       which support wildcards. For example, 'P*SCAN*' would match
  668.       'PALMSCAN.EXE'.
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.                                       - 12 -
  722.       PalmScan v2.01                                             User guide
  723.       ---------------------------------------------------------------------
  724.  
  725.       2  Installation
  726.       ---------------
  727.  
  728.       2.1  First time installation
  729.       ----------------------------
  730.  
  731.       PalmScan and all files included can be placed either in a separate
  732.       directory, or in the BBS directory. the most common way is creating a
  733.       sub-directory under the BBS directory, and place the files there.
  734.       After placing all files in a directory, edit PALMSCAN.CFG.
  735.  
  736.  
  737.       2.2.1  Installing PalmScan in FileDoor
  738.       --------------------------------------
  739.  
  740.       The most common way for installing PalmScan in FileDoor is the
  741.       following:
  742.  
  743.       ExitAfterUpload1 C:\PALMSCAN\PALMSCAN.EXE $U\*.* $N $M
  744.  
  745.       $U\*.*    tells PalmScan which files to process.
  746.       $N        tells FileDoor to execute PalmScan only when files are
  747.                 received.
  748.       $M        tells FileDoor to swap to disk/EMS before executing
  749.                 PalmScan.
  750.  
  751.       I recommend using the 'Online Filedoor' keyword in the configuration,
  752.       PalmScan will then tell FileDoor the new filename when a file has
  753.       been converted, and the original size of the archive. By using
  754.       'FileID' also, PalmScan will also tell FileDoor the description (when
  755.       found in FILE_ID.DIZ or DESC.SDI). You should never use 'FilesBBS'
  756.       when running under FileDoor.
  757.  
  758.  
  759.       2.2.2  Installing PalmScan in SuperBBS
  760.       --------------------------------------
  761.  
  762.       The most common way for installing PalmScan in SuperBBS is the
  763.       following:
  764.  
  765.       Virus scanner: c:\xfd\palmscan\palmscan.exe %1 *S
  766.  
  767.       %1   tells PalmScan which file to process.
  768.       *S   tells SuperBBS to swap to disk/EMS before executing PalmScan.
  769.  
  770.       You should not use archive conversion when PalmScan is used as virus
  771.       scanner in SuperBBS. After uploads, SuperBBS would not be
  772.       able to find the file back when it has got another filename.
  773.       For using archive conversion, you should run PalmScan in an event,
  774.       with 'FilesBBS' and 'OnlyNewFiles' switched on.
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.                                       - 13 -
  785.       PalmScan v2.01                                             User guide
  786.       ---------------------------------------------------------------------
  787.  
  788.       2.2.3  Installing PalmScan in Allfix
  789.       ------------------------------------
  790.  
  791.       Allfix version 4.21 (and later) and Allfix/2 version 1.00 (and later)
  792.       have the option to use an external archive conversion utility. The
  793.       most common way for installing PalmScan in Allfix at this option is
  794.       the following:
  795.  
  796.       EAC : PALMSCAN.EXE @1 /L
  797.  
  798.       /L   tells PalmScan to run in local-only mode (Allfix doesn't have a
  799.            user online anyway...) .
  800.       @1   tells PalmScan which file to process.
  801.  
  802.       The errorlevels should be configured like this:
  803.  
  804.       (EAC) virus errorlevel 198
  805.       (EAC) error errorlevel 1
  806.  
  807.       PalmScan returns errorlevel 203 for bad archives (archives which
  808.       can't be unpacked), errorlevel 212 for hacked files and errorlevel
  809.       213 for virus-infected archives.
  810.       With these errorlevel settings in Allfix, it will move the file to
  811.       the bad directory if one of these occur.
  812.  
  813.       You should not configure a 'BadPath' and 'InfectedPath' in the
  814.       PalmScan configuration, Allfix will move bad or infected archives to
  815.       the BadTick directory (when the errorlevels are configured as above).
  816.       Also, 'FilesBBS', 'FDB' and 'FileDoor' should not be used, else
  817.       PalmScan would create files which are of no use for Allfix.
  818.  
  819.  
  820.       2.2.4  Installing PalmScan in RemoteAccess 2.xx
  821.       -----------------------------------------------
  822.  
  823.       The commandline for using PalmScan in the upload scan option in
  824.       RemoteAccess 2.xx should be:
  825.  
  826.       PALMSCAN.EXE @ *M
  827.  
  828.       If you are using the file-database in RemoteAccess 2.xx, you should
  829.       also enable this option ('FDB RA') in the PalmScan configuration.
  830.  
  831.  
  832.       2.2.5  Installing PalmScan in RAFT (The Remote Access Filearea Tools)
  833.       ---------------------------------------------------------------------
  834.  
  835.       The commandline for using PalmScan in the ARCCONV option in The
  836.       Remote Access Filearea Tools is:
  837.  
  838.       PALMSCAN.EXE %F @1 /L
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.                                       - 14 -
  848.       PalmScan v2.01                                             User guide
  849.       ---------------------------------------------------------------------
  850.  
  851.       2.2.6  Installing PalmScan in Maximus
  852.       -------------------------------------
  853.  
  854.       If you don't already use the VirusCheck option in Maximus, you should
  855.       first uncomment the following line in MAX.CTL:
  856.  
  857.            Upload Check Virus   Vircheck.Bat
  858.  
  859.       If you want to use the DORINFOx.DEF support of PalmScan, you should
  860.       also make a few changes to the MENUS.CTL file. Usually the upload
  861.       command is looking like this:
  862.  
  863.            Upload                                  Limited "Upload (send)"
  864.  
  865.       Maximus includes a mecca script called DORINFO.MEC, which produces a
  866.       DORINFO1.DEF. The new structure of the upload command should be as
  867.       follows:
  868.  
  869.                      Display_File C:\Max\Dorinfo   Limited "Upload (send)"
  870.            NoDsp     Upload                        Limited "U"
  871.  
  872.       This way whenever a user begins the upload procedure, a DORINFO1.DEF
  873.       file is created.
  874.       You can now edit the VIRCHECK.BAT to include the following:
  875.  
  876.            PalmScan %1%2%3 /NoConversion /D[path to DORINFOx.DEF]
  877.  
  878.       If you don't want to use the DORINFOx.DEF support, it should be this
  879.       way:
  880.  
  881.            PalmScan %1%2%3 /NoConversion /L
  882.  
  883.       Warning! Do not use spaces between the commandline variables (%1,%2
  884.       and %3) or nothing will work properly.
  885.  
  886.       You can find the location where the DORINFOx.DEF file will be created
  887.       by viewing the DORINFO.MEC file, located in the Misc directory.
  888.  
  889.       You must not forget to SILT (compile) the configuration after
  890.       changing the .CTL files.
  891.  
  892.       When PalmScan finds the archive to be bad or infected, it will remove
  893.       it from the upload directory. After returning to the BBS, Maximus
  894.       will then not find the file present and it won't credit the user for
  895.       it, and the file won't be placed in the FILES.BBS.
  896.       The 'ArchiveConversion' keyword should not be used in the PalmScan
  897.       configuration for running PalmScan inside Maximus, while Maximus
  898.       would think the file is missing when the filename is changed. You can
  899.       also use the /NOCONVERSION commandline option for PalmScan instead of
  900.       disabling the ArchiveConversion keyword (this can be especially
  901.       useful when using PalmScan to convert the archives in an event, and
  902.       using only one configuration for PalmScan).
  903.  
  904.       For doing archive conversions, FileID insertion and FILES.BBS update
  905.       options, run PalmScan in an event or just after exiting Maximus, with
  906.       the 'OnlyNewFiles', 'FileID' and 'FilesBBS' keywords turned on.
  907.  
  908.  
  909.  
  910.                                       - 15 -
  911.       PalmScan v2.01                                             User guide
  912.       ---------------------------------------------------------------------
  913.  
  914.       2.2.7  Installing PalmScan in Ezycom
  915.       ------------------------------------
  916.  
  917.       There are various ways of using PalmScan with Ezycom. When using
  918.       PalmScan in one of the conversion batch-files used by Ezycom,
  919.       PalmScan will not update the Ezycom file-database. Ezycom will handle
  920.       this itself, so you should disable 'FDB Ezycom' when PalmScan is
  921.       started from one of those batch-files.
  922.       When using PalmScan with UPCONV.BAT, the commandline should be as
  923.       follows for Ezycom 1.02:
  924.  
  925.       PalmScan.Exe %1%4.%6 /NoFDB /NoFilesBBS
  926.  
  927.       For Ezycom 1.10, the commandline should be:
  928.  
  929.       PalmScan.Exe %2%5.%7 /N%1 /T%6 /NoFDB /NoFilesBBS
  930.  
  931.       'Online Ezycom' can be used to make PalmScan pass on the file
  932.       description to Ezycom.
  933.  
  934.       When used in DOCONV.BAT, /L should be added to that.
  935.       The best way to use PalmScan with Ezycom is by not using it in these
  936.       batch-files, but running it in an event with the FDB maintenance
  937.       feature (/FDBMAINT commandline option). You could also run PalmScan
  938.       after every caller, processing only the upload directory
  939.       (/FDBMAINT<areanr>).
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.                                       - 16 -
  974.       PalmScan v2.01                                             User guide
  975.       ---------------------------------------------------------------------
  976.  
  977.       2.2.8  Installing PalmScan in Concord
  978.       -------------------------------------
  979.  
  980.       The best way to use PalmScan with Concord is to use the file-database
  981.       maintenance feature (/FDBmaint commandline option). PalmScan will
  982.       then process all files which have not been processed yet, and update
  983.       the Concord file-database. This can also be done while the user is
  984.       still on-line, by creating a simple menu which first executes the
  985.       upload feature of Concord, and then runs the PalmScan file-database
  986.       maintenance for the specific upload area.
  987.  
  988.       To install PalmScan in the upload checker feature, this has to be
  989.       configured in the Concord configuration:
  990.  
  991.       -    At the file-system section, the extended upload checker should
  992.            be turned ON.
  993.       -    At the paths section, PalmScan should be configuration as virus
  994.            scanner. At the time this documentation is being written, it is
  995.            not yet known how Concord calls the upload checker, please
  996.            consult the Concord manual for that.
  997.  
  998.       PalmScan should not update the Concord file-database when running as
  999.       upload checker, so FDB Concord should not be used, or /NoFDB should
  1000.       be added to the PalmScan commandline. You should use 'Online Concord'
  1001.       if you want PalmScan to pass on the file description to Concord.
  1002.  
  1003.  
  1004.       2.2.9  Installing PalmScan in ProBoard
  1005.       --------------------------------------
  1006.  
  1007.       By using PalmUpload, a ProBoard extension (PEX) file, it is very easy
  1008.       to use PalmScan as upload checker under ProBoard.
  1009.  
  1010.       PalmUpload must be installed as a menu function 60 (Run ProBoard SDK
  1011.       file), which should replace the regular upload feature.
  1012.       Menu Data : PUPLOAD [PalmScan path]
  1013.       You must specify the directory where PalmScan.EXE can be found at the
  1014.       data field. Example : PUPLOAD C:\PALMSCAN
  1015.       That's really all there is to it... PalmUpload will first perform the
  1016.       upload as regular (it will use the default upload directory as
  1017.       configured in the ProBoard configuration). After that, PalmScan will
  1018.       be started, which can then do anything you want with the uploaded
  1019.       files. After PalmScan has finished processing all uploaded files,
  1020.       PalmUpload will check if the files have passed. If they haven't
  1021.       (because of a bad archive, infected files found, etc.), the file will
  1022.       be subtracted from the user's number of uploaded files and kilobytes.
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.                                       - 17 -
  1037.       PalmScan v2.01                                             User guide
  1038.       ---------------------------------------------------------------------
  1039.  
  1040.       2.3  Commandline
  1041.       ----------------
  1042.  
  1043.       The PalmScan commandline consists of:
  1044.  
  1045.       PALMSCAN.EXE [FileSpecs|@ListFile|Command] <Options>
  1046.  
  1047.       [..] is mandatory
  1048.       <..> is optional
  1049.  
  1050.       [FileSpecs]    must be valid DOS file-specifications. At least one
  1051.                      should be given, up to 30 can be given.
  1052.                      File-specifications can be either filenames or
  1053.                      directories. In the last case, all files in that
  1054.                      directory will be processed.
  1055.  
  1056.       Example :      PalmScan *.ZIP
  1057.  
  1058.       [@ListFile]    Instead of (a) file-specification(s), you can also use
  1059.                      a listfile. This listfile should contain valid
  1060.                      file-specifications (see above). PalmScan will process
  1061.                      all file-specifications in the listfile (there is no
  1062.                      maximum size for the listfile!). The
  1063.                      file-specifications should be placed on the first part
  1064.                      of each line, 2everything behind it will be ignored.
  1065.  
  1066.                      Example listfile:
  1067.  
  1068.                      d:\files\upload     This is the upload directory
  1069.                      d:\files\incoming   This is the incoming files
  1070.                                          directory
  1071.  
  1072.                      In this example, all files in the directory's
  1073.                      d:\files\upload and d:\files\incoming, will be
  1074.                      processed (except for those files configured with the
  1075.                      SkipFile keyword in the PalmScan configuration). The
  1076.                      comments behind the directory's will be ignored.
  1077.                      You can also use FLSEARCH.CTL (QuickBBS format) with
  1078.                      this option.
  1079.  
  1080.       Example :      PalmScan @C:\BBS\FLSEARCH.CTL
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.                                       - 18 -
  1100.       PalmScan v2.01                                             User guide
  1101.       ---------------------------------------------------------------------
  1102.  
  1103.       [Command] :
  1104.  
  1105.       /FDBmaint<areanr<-areanr>>
  1106.  
  1107.            Usage   : Run Ezycom/RemoteAccess/Concord file-database
  1108.                      maintenance. PalmScan will first search the
  1109.                      file-database for files which have not been processed,
  1110.                      and place them in a file called FILEINFO.FIX. After
  1111.                      that, the PalmScan FileInfo system will take over and
  1112.                      those files will be processed. Files will be converted
  1113.                      to the archiver configured in the file-area
  1114.                      configuration. When no archiver is configured for an
  1115.                      area, PalmScan will not process files in that area.
  1116.                      (Except for Concord, at this moment no archiver can be
  1117.                      configured in the file-area configuration so all areas
  1118.                      will be processed).
  1119.                      When running with Ezycom or Concord, PalmScan will use
  1120.                      the checked bit in the file-database to determine
  1121.                      wether a file has been processed or not.
  1122.                      When running with RemoteAccess, PalmScan uses
  1123.                      LASTSCAN.PS in the file-database directory to store
  1124.                      the last time when the FDB maintenance has been run.
  1125.                      All files which have an upload date after the date of
  1126.                      that file will be processed.
  1127.                      When running with Concord, PalmScan will only do
  1128.                      virus-scanning when that's configured in the file-area
  1129.                      configuration.
  1130.  
  1131.                      <areanr-<areanr>>   The area numbers which should be
  1132.                                          processed. A range of areas can be
  1133.                                          given here (eg. 10-20) or just one
  1134.                                          area can be given.
  1135.                                          When no area number is specified,
  1136.                                          PalmScan will process all areas
  1137.                                          which have a destination archiver
  1138.                                          configured.
  1139.  
  1140.                      Any file specifications given on the commandline will
  1141.                      be used to determine wether a file should be processed
  1142.                      or not.
  1143.  
  1144.            Options : /All      Process all files in the specified areas,
  1145.                                even if they have already been processed.
  1146.  
  1147.                      /AnyArea  Process any area, instead of only areas
  1148.                                which have a target archiver set.
  1149.  
  1150.            Example : PalmScan.Exe /L /FDBMAINT50-99 /ALL *.ARJ
  1151.                         - This will process all *.ARJ files which are in
  1152.                           the file-database in areas in the range 50 to 99
  1153.                           which have a destination archiver configured in
  1154.                           the file-area configuration.
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.                                       - 19 -
  1163.       PalmScan v2.01                                             User guide
  1164.       ---------------------------------------------------------------------
  1165.  
  1166.       /Fix<+>
  1167.  
  1168.            Usage   : Use the PalmScan FileInfo system. This system
  1169.                      accomplishes an enhanced communication between
  1170.                      PalmScan and programs using PalmScan. When using /FIX,
  1171.                      PalmScan will use the FileInfo system in Read-Only
  1172.                      mode, the FileInfo file (FILEINFO.FIX) will be deleted
  1173.                      when all files have been processed.
  1174.                      When using /FIX+, PalmScan will use the FileInfo
  1175.                      system in Read/Write mode. PalmScan will update the
  1176.                      FileInfo file with some information that can be used
  1177.                      by the program which is calling PalmScan.
  1178.                      Technical information about the FileInfo system can be
  1179.                      found in FILEINFO.INC, which is included in the
  1180.                      PalmScan package.
  1181.  
  1182.  
  1183.       <options> :
  1184.  
  1185.       /L
  1186.  
  1187.            Usage   : Local operation. When this switch is NOT used,
  1188.                      PalmScan will search for DOOR.SYS and/or DORINFO?.DEF
  1189.                      to get the user information from.
  1190.  
  1191.  
  1192.       /C[configuration-filename]
  1193.  
  1194.            Usage   : By default, PalmScan will search for it's
  1195.                      configuration file in the same directory where
  1196.                      PALMSCAN.EXE is placed, with the filename
  1197.                      PALMSCAN.CFG. With this commandline option, you can
  1198.                      tell PalmScan to use an alternate configuration file.
  1199.  
  1200.            Example : /Cc:\palmscan\afixpalm.cfg
  1201.  
  1202.       /D[dorinfo-filename]
  1203.  
  1204.            Usage   : When your BBS-package creates a DORINFO file with a
  1205.                      filename that can't be found by searching for
  1206.                      DORINFO?.DEF (ie. Ezycom can create DORINF85.DEF for
  1207.                      line 85), you can specify this filename here.
  1208.  
  1209.            Example : /Ddorinf85.def
  1210.  
  1211.       /N[node]
  1212.  
  1213.            Usage   : When the node number is specified with this
  1214.                      commandline option, PalmScan's multi-line support is
  1215.                      enabled. This makes sure that PalmScan will run
  1216.                      without problems when running on more nodes at the
  1217.                      same time on multi-node systems.
  1218.                      This commandline option is required when using the
  1219.                      EzyFileID configuration keyword.
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.                                       - 20 -
  1226.       PalmScan v2.01                                             User guide
  1227.       ---------------------------------------------------------------------
  1228.  
  1229.       /NoChanges
  1230.  
  1231.            Usage   : When this option is used, no archiving will be done at
  1232.                      all. This means that no archive will be converted,
  1233.                      there won't be any file removal or file adding, no
  1234.                      music modules will be described, and the archive
  1235.                      header will not be updated. This can be especially
  1236.                      useful for running PalmScan as online virus scanner
  1237.                      (when the archive conversion is done in an event), or
  1238.                      for just updating file descriptions in FILES.BBS with
  1239.                      the 'FileID' keyword used.
  1240.  
  1241.       /NoConversion
  1242.  
  1243.  
  1244.            Usage   : When this option is used, archive conversion is not
  1245.                      done. All other function will be performed.
  1246.  
  1247.       /T[archiver]
  1248.  
  1249.            Usage   : Override the configured destination archiver.
  1250.                      When no archiver is configured in the PalmScan
  1251.                      configuration, PalmScan will only convert the main
  1252.                      archives, no embedded archives. When there is an
  1253.                      archiver configured in the PalmScan configuration,
  1254.                      those settings will be used for SFX/Secure/Embedded
  1255.                      archives.
  1256.                      When used when running the file-database maintenance,
  1257.                      PalmScan will still only process those areas which
  1258.                      have a destination archiver configured (in the
  1259.                      Ezycom/RemoteAccess file-area configuration). This
  1260.                      commandline option does override that configured
  1261.                      archiver, though.
  1262.  
  1263.            Example : /TARJ
  1264.  
  1265.            Note    : This is a bonus feature, which is available in the
  1266.                      registered version only.
  1267.  
  1268.       /NoFDB
  1269.  
  1270.            Usage   : Temporary disable the file-database support.
  1271.  
  1272.            Note    : This is a bonus feature, which is available in the
  1273.                      registered version only.
  1274.  
  1275.       /NoFilesbbs
  1276.  
  1277.            Usage   : Temporary disable the files.bbs support.
  1278.  
  1279.            Note    : This is a bonus feature, which is available in the
  1280.                      registered version only.
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.                                       - 21 -
  1289.       PalmScan v2.01                                             User guide
  1290.       ---------------------------------------------------------------------
  1291.  
  1292.  
  1293.       /S
  1294.  
  1295.            Usage   : When this option is used, PalmScan will search all
  1296.                      sub-directory's of the given file-specifications for
  1297.                      files to be processed. Together with the
  1298.                      ProcessListedOnly configuration keyword, this option
  1299.                      can very well be used to process all files on a
  1300.                      bulletin board.
  1301.  
  1302.       /Unlisted
  1303.  
  1304.            Usage   : When this option is used, PalmScan will only process
  1305.                      files which are not listed in FILES.BBS and/or the
  1306.                      RemoteAccess/Ezycom/Concord file-database. This
  1307.                      commandline option overrides the ProcessListedOnly
  1308.                      configuration keyword.
  1309.  
  1310.       /Move[Path]
  1311.  
  1312.            Usage   : When a file has been processed and is ok, it can be
  1313.                      moved to another directory.
  1314.  
  1315.                      [Path]    The directory where good files will be moved
  1316.                                to.
  1317.  
  1318.            Note    : This is a bonus feature, which is available in the
  1319.                      registered version only.
  1320.  
  1321.       /V[Size]
  1322.  
  1323.            Usage   : To use the multi-volume packing (MultiVolumePack
  1324.                      configuration keyword), the target size must be
  1325.                      specified on the PalmScan commandline, using this
  1326.                      commandline option.
  1327.  
  1328.                      [Size]    The target size of the multi-volume
  1329.                                archives. This parameter is passed on
  1330.                                directly to the archiver when PalmScan
  1331.                                starts packing the archives.
  1332.  
  1333.       /NoMove
  1334.  
  1335.            Usage   : Temporary disable the moving of files to the BadPath,
  1336.                      InfectedPath, HackPath, OldPath and BadGifPath. When
  1337.                      needed, PalmScan will exit with an errorlevel instead
  1338.                      of moving any files.
  1339.  
  1340.            Note    : This is a bonus feature, which is available in the
  1341.                      registered version only.
  1342.  
  1343.       /NoScan
  1344.  
  1345.            Usage   : Temporary disable virus-scanning.
  1346.  
  1347.            Note    : This is a bonus feature, which is available in the
  1348.                      registered version only.
  1349.  
  1350.  
  1351.                                       - 22 -
  1352.       PalmScan v2.01                                             User guide
  1353.       ---------------------------------------------------------------------
  1354.  
  1355.       /Mono
  1356.  
  1357.            Usage   : Forces monochrome mode.
  1358.  
  1359.       /NoCls
  1360.  
  1361.            Usage   : Do not clear the screen at startup.
  1362.  
  1363.       /Debug
  1364.  
  1365.            Usage   : This will log some more information on the execution
  1366.                      of external programs (such as virus scanners,
  1367.                      archivers, etc.) and virtually anything which is
  1368.                      displayed on the screen.
  1369.  
  1370.       /P[priority]
  1371.  
  1372.            Usage   : This option is only available in the OS/2 version of
  1373.                      PalmScan. The priority of the process can be set using
  1374.                      this commandline option.
  1375.  
  1376.                      [priority]     This is a percentage of the normal
  1377.                                     priority. It can be a value from 0 to
  1378.                                     257. The default priority is 100.
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.                                       - 23 -
  1415.       PalmScan v2.01                                             User guide
  1416.       ---------------------------------------------------------------------
  1417.  
  1418.       2.4  Watchdog, CTTY, ANSI.SYS
  1419.       -----------------------------
  1420.  
  1421.       CTTY and WATCHDOG, or similar utilities, are not required and should
  1422.       not be used with this program. PalmScan has its own communication
  1423.       routines which monitor the COM port.
  1424.  
  1425.       ANSI.SYS is not required for this program. When running under
  1426.       DESQview, DVANSI is not required either. It won't do any harm if
  1427.       either one is loaded however.
  1428.  
  1429.  
  1430.       2.5  Errorlevels
  1431.       ----------------
  1432.  
  1433.       PalmScan returns the following errorlevels:
  1434.  
  1435.       1    -    Error
  1436.       203  -    Bad archive found
  1437.       204  -    Old file found
  1438.       205  -    Bad GIF file found
  1439.       212  -    Hacked archive found
  1440.       213  -    Infected file found
  1441.  
  1442.       The errorlevels 203, 204, 205, 212 and 213 will only be returned when
  1443.       no directory is configured to move those files to.
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.                                       - 24 -
  1478.       PalmScan v2.01                                             User guide
  1479.       ---------------------------------------------------------------------
  1480.  
  1481.       3  The configuration
  1482.       --------------------
  1483.  
  1484.       3.1  PALMSCAN.CFG
  1485.       -----------------
  1486.  
  1487.       The PALMSCAN.CFG file is a normal (ASCII) text-file. You can create
  1488.       this file with any ASCII-editor. PalmScan will search for its
  1489.       configuration file in the directory containing PALMSCAN.EXE, or the
  1490.       configuration file specified on the commandline (see chapter 2.7).
  1491.  
  1492.       If no configuration file is found, PalmScan will terminate
  1493.       abnormally.
  1494.  
  1495.       PALMSCAN.CFG contains many options. Some of them are optional, others
  1496.       are not. The general format for the PALMSCAN.CFG file is:
  1497.  
  1498.       {statement} [mandatory parameter] <optional parameter>
  1499.  
  1500.       There are no restrictions to the position you start the parameters,
  1501.       but the parameters have to be separated with one or more spaces. The
  1502.       {statement} must start on position 1 of each line.
  1503.  
  1504.       When there should be spaces in a parameter (like in the archiver
  1505.       commands), you can use underscores ('_') for that, PalmScan will
  1506.       translate those in spaces.
  1507.  
  1508.       You can insert comment-lines into PALMSCAN.CFG by putting a '%' or a
  1509.       ';' character on position 1 of the desired line(s). Also empty lines
  1510.       are considered as comment.
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.                                       - 25 -
  1541.       PalmScan v2.01                                             User guide
  1542.       ---------------------------------------------------------------------
  1543.  
  1544.       3.2  PSetup
  1545.       -----------
  1546.  
  1547.       Besides editing the configuration file with an ASCII editor, you can
  1548.       also configure PalmScan with PSetup. PSetup uses the same ASCII
  1549.       text-file as PalmScan.
  1550.  
  1551.  
  1552.       3.2.1  Commandline
  1553.       ------------------
  1554.  
  1555.       The PSetup commandline consists of:
  1556.  
  1557.       PSETUP [configuration-filename] </A|-A>
  1558.  
  1559.       [configuration-filename]
  1560.  
  1561.            Usage   : By default, PSetup will search for it's configuration
  1562.                      file in the same directory where PSETUP.EXE is placed,
  1563.                      with the filename PALMSCAN.CFG. With this commandline
  1564.                      option, you can tell PSetup to use an alternate
  1565.                      configuration file.
  1566.  
  1567.       </A|-A>
  1568.  
  1569.            Usage   : When PSetup is started with /A or -A on the
  1570.                      commandline, it will use an alternate colorset.
  1571.  
  1572.       Example : PSETUP c:\palmscan\afixpalm.cfg /A
  1573.  
  1574.  
  1575.       3.2.2  Starting PSetup
  1576.       ----------------------
  1577.  
  1578.       When you run PSetup, it will look for the configuration file as
  1579.       stated in paragraph 3.2.1. When no configuration file is found, it
  1580.       will inform you of this. The configuration file will then be created
  1581.       when you exit PSetup.
  1582.  
  1583.  
  1584.       3.2.3  Keys
  1585.       -----------
  1586.  
  1587.       PSetup uses pop-up menus. You can use the cursor up and down keys to
  1588.       move through the menus, and select an option by pressing Enter. The
  1589.       Escape key will take you back to a previous level.
  1590.       In all edit fields, Escape aborts and F10 keeps changes immediately
  1591.       (if you didn't select the 'Cancel' button).
  1592.       Cursor-Down and Tab moves the cursor to the next field, Cursor-Up and
  1593.       Shift-Tab moves the cursor to the previous field.
  1594.       Enter will move the cursor to the next field when on an edit field,
  1595.       and press a button when that button is currently selected.
  1596.       The space bar toggles on/off settings, Cursor-Left/Right will move
  1597.       through selection fields.
  1598.       F1 will display the relevant part of the PalmScan documentation when
  1599.       the cursor is located on a data entry. PalmScan.Doc must be located
  1600.       in the same directory where PSetup.Exe is located for this function
  1601.       to work.
  1602.  
  1603.                                       - 26 -
  1604.       PalmScan v2.01                                             User guide
  1605.       ---------------------------------------------------------------------
  1606.  
  1607.       3.3  System data
  1608.       ----------------
  1609.  
  1610.       3.3.1  Site Information
  1611.       -----------------------
  1612.  
  1613.       BBS name
  1614.       --------
  1615.  
  1616.       This option informs PalmScan of your BBS name. This option is only of
  1617.       use when you registered PalmScan and also filled in the key number.
  1618.  
  1619.       Example   :    Oasis BBS
  1620.  
  1621.       Keyword   :    BBSname [BBS_name]
  1622.  
  1623.            [BBS_name]     This is your BBS name.
  1624.  
  1625.            Example   :    BBSname Oasis_BBS
  1626.  
  1627.  
  1628.       SysOp name
  1629.       ----------
  1630.  
  1631.       This option informs PalmScan of the name of the system operator. When
  1632.       writing a message, PalmScan will write it to this name. When no name
  1633.       is configured, the message will be addressed to 'SysOp'.
  1634.  
  1635.       Example   :    Steven Hendriks
  1636.  
  1637.       Keyword   :    SysopName [Sysop_Name]
  1638.  
  1639.            [Sysop_Name]   The name of the system operator.
  1640.  
  1641.            Example   :    SysopName Steven_Hendriks
  1642.  
  1643.  
  1644.       Key number
  1645.       ----------
  1646.  
  1647.       When you registered PalmScan, you received a key for use with
  1648.       PalmScan. This key must be entered here, to make PalmScan work in
  1649.       registered mode. You must also use the registered version for this to
  1650.       work. If you don't have the registered version, please contact your
  1651.       local registration site or the main registration site for more
  1652.       information. If you have not already registered PalmScan, please see
  1653.       the registration form for details on how to register.
  1654.  
  1655.       Example   :    12345678901234567890123456789012
  1656.  
  1657.       Keywords  :    RegKey [Key number]
  1658.                      OS2key [Key number]
  1659.  
  1660.                 [Key number]   This is your key number as you receive it
  1661.                                after registering PalmScan.
  1662.  
  1663.                 Examples  :    RegKey 12345678901234567890123456789012
  1664.                                OS2key 12345678901234567890123456789012
  1665.  
  1666.                                       - 27 -
  1667.       PalmScan v2.01                                             User guide
  1668.       ---------------------------------------------------------------------
  1669.  
  1670.       3.3.2  Screen settings
  1671.       ----------------------
  1672.  
  1673.       Redirect screen output of external programs
  1674.       -------------------------------------------
  1675.  
  1676.       PalmScan can redirect output of external programs (archivers and
  1677.       virus-scanners) to NUL. This means that those programs will display
  1678.       nothing to the local screen. Some programs, however, will still get
  1679.       output on the screen (like TBScan and F-Prot). When that happens,
  1680.       PalmScan will restore the screen to it's original looks after the
  1681.       external program has been executed. Enabling this option will cause
  1682.       the display on the local screen to be exactly the same as the display
  1683.       on the user screen (when running in on-line mode).
  1684.  
  1685.       Example   :    X
  1686.  
  1687.       Keyword   :    RedirectOutput
  1688.  
  1689.            Example   :    RedirectOutput
  1690.  
  1691.  
  1692.       Normal color
  1693.       ------------
  1694.  
  1695.       With this option, you can configure the color of normal text in
  1696.       PalmScan.
  1697.  
  1698.       Example   :    3
  1699.  
  1700.       Keyword   :    ColorNormal [c]
  1701.  
  1702.            [c]            This is the color number. This can be any value
  1703.                           from 0 to 15.
  1704.  
  1705.            Example   :    ColorNormal 3
  1706.  
  1707.  
  1708.       Highlighted color
  1709.       -----------------
  1710.  
  1711.       With this option, you can configure the color of highlighted text in
  1712.       PalmScan.
  1713.  
  1714.       Example   :    11
  1715.  
  1716.       Keyword   :    ColorHighlight [c]
  1717.  
  1718.            [c]            This is the color number. This can be any value
  1719.                           from 0 to 15.
  1720.  
  1721.            Example   :    ColorHighlight 11
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.                                       - 28 -
  1730.       PalmScan v2.01                                             User guide
  1731.       ---------------------------------------------------------------------
  1732.  
  1733.       Background color
  1734.       ----------------
  1735.  
  1736.       With this option, you can configure the background color in PalmScan.
  1737.  
  1738.       Example   :    0
  1739.  
  1740.       Keyword   :    ColorBackground [c]
  1741.  
  1742.            [c]            This is the color number. This can be any value
  1743.                           from 0 to 7.
  1744.  
  1745.            Example   :    ColorBackground 0
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.                                       - 29 -
  1793.       PalmScan v2.01                                             User guide
  1794.       ---------------------------------------------------------------------
  1795.  
  1796.       3.3.3  Pathnames
  1797.       ----------------
  1798.  
  1799.       Temporary directory
  1800.       -------------------
  1801.  
  1802.       This should point to a directory where PalmScan can store temporary
  1803.       files. This directory is necessary for running PalmScan.
  1804.       When no temporary directory is configured, PalmScan will use the TEMP
  1805.       environment variable (when available). For more information about
  1806.       environment variables, consult your DOS or OS/2 documentation.
  1807.  
  1808.       Example   :    C:\TEMP
  1809.  
  1810.       Keyword   :    TempPath [d:\path]
  1811.  
  1812.            [d:\path]      This is the directory where the temporary files
  1813.                           will be stored.
  1814.  
  1815.            Example   :    TempPath C:\TEMP
  1816.  
  1817.  
  1818.       Bad files directory
  1819.       -------------------
  1820.  
  1821.       When a bad file has been encountered (ie. the file cannot be unpacked
  1822.       although it is an archive), PalmScan can move it to this directory.
  1823.       When this option is not used, PalmScan will exit with errorlevel 203
  1824.       instead of moving the bad archive.
  1825.  
  1826.       Example   :    C:\FILES\BAD
  1827.  
  1828.       Keyword   :    BadPath [d:\path]
  1829.  
  1830.            [d:\path]      This is the directory where PalmScan will move
  1831.                           bad files to.
  1832.  
  1833.            Example   :    BadPath C:\FILES\BAD
  1834.  
  1835.  
  1836.       Infected files directory
  1837.       ------------------------
  1838.  
  1839.       When a virus has been found, PalmScan will move the file so you can
  1840.       investigate it further. When this keyword is not used, PalmScan will
  1841.       exit with errorlevel 213 instead of moving the infected file.
  1842.  
  1843.       Example   :    C:\FILES\INFECTED
  1844.  
  1845.       Keyword   :    InfectedPath [d:\path]
  1846.  
  1847.            [d:\path]      This is the directory where PalmScan will move
  1848.                           infected files to.
  1849.  
  1850.            Example   :    InfectedPath C:\FILES\INFECTED
  1851.  
  1852.  
  1853.  
  1854.  
  1855.                                       - 30 -
  1856.       PalmScan v2.01                                             User guide
  1857.       ---------------------------------------------------------------------
  1858.  
  1859.       Hacked files directory
  1860.       ----------------------
  1861.  
  1862.       When a file has been found in the hacklist, PalmScan will move this
  1863.       file so you can investigate it further. When this keyword is not
  1864.       used, PalmScan will exit with errorlevel 212 instead of moving the
  1865.       hacked file.
  1866.  
  1867.       Example   :    C:\FILES\HACKED
  1868.  
  1869.       Keyword   :    HackPath [d:\path]
  1870.  
  1871.            Example   :    HackPath C:\FILES\HACKED
  1872.  
  1873.  
  1874.       Old files directory
  1875.       -------------------
  1876.  
  1877.       PalmScan can check for files which are too old. When this check is
  1878.       configured (see the Old files section), old files will be moved to
  1879.       the path configured with this option. When no directory is configured
  1880.       here, PalmScan will exit with errorlevel 204 when encountering files
  1881.       which are too old.
  1882.  
  1883.       Example   :    C:\FILES\OLD
  1884.  
  1885.       Keyword   :    OldPath [d:\path]
  1886.  
  1887.            Example   :    OldPath C:\FILES\OLD
  1888.  
  1889.  
  1890.       Bad GIF files directory
  1891.       -----------------------
  1892.  
  1893.       When a bad graphics image (a graphics image with a resolution which
  1894.       is too low (MinimumResolution configuration keyword) or which failed
  1895.       the GIF test (GIFtest configuration keyword), the file will be moved
  1896.       to the directory configured here. When no directory is configured
  1897.       here, PalmScan will exit with errorlevel 205 on bad graphics images.
  1898.  
  1899.       Keyword   :    BadGifPath [d:\path]
  1900.  
  1901.            Example   :    BadGifPath C:\FILES\BADGIF
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.                                       - 31 -
  1919.       PalmScan v2.01                                             User guide
  1920.       ---------------------------------------------------------------------
  1921.  
  1922.       Substitute drive
  1923.       ----------------
  1924.  
  1925.       When archiving files with sub-directory's, some archivers add
  1926.       complete path names instead of only the sub-directory's names to the
  1927.       archives. PalmScan can use a substituted drive for the archive
  1928.       conversion to make sure the correct directory names are in the
  1929.       archives. PalmScan will then call SUBST before every pack/unpack
  1930.       command.
  1931.       With the default archiver settings, this option is not necessary.
  1932.  
  1933.       Note      :    This option is not available in the OS/2 version of
  1934.                      PalmScan, while the SUBST command is not available in
  1935.                      OS/2.
  1936.  
  1937.       Example   :    F
  1938.  
  1939.       Keyword   :    SubstDrive [Drive letter]
  1940.  
  1941.            [Drive letter] The drive letter must be an unused drive and
  1942.                           should be available when PalmScan is running
  1943.                           (please test it with the SUBST command before
  1944.                           using it in PalmScan). When an error occurs while
  1945.                           SUBST is being called, PalmScan will use the
  1946.                           normal pathname.
  1947.  
  1948.            Example   :    SubstDrive F
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.                                       - 32 -
  1982.       PalmScan v2.01                                             User guide
  1983.       ---------------------------------------------------------------------
  1984.  
  1985.       3.3.4  Files Lists
  1986.       ------------------
  1987.  
  1988.       Here a number of files-lists can be configured. When the files-list
  1989.       have been configured here, they can be edited using PSetup.
  1990.  
  1991.  
  1992.       Hacked files list
  1993.       -----------------
  1994.  
  1995.       PalmScan can check a HackList (eg. 'The Hack Report') for dangerous
  1996.       or unwanted files. This HackList contains filenames or file-
  1997.       specifications which PalmScan will reject. When a filename without an
  1998.       extension is configured, PalmScan will assume '.*' (without quotes).
  1999.       The hacklist can contain other information after a comma, which will
  2000.       be ignored by PalmScan.
  2001.  
  2002.       Example   :    C:\PALMSCAN\PALMSCAN.HCK
  2003.  
  2004.       Keyword   :    HackList [d:\path\filename.ext]
  2005.  
  2006.            [d:\path\filename.ext]   This is the full path and filename of
  2007.                                     the HackList to use.
  2008.  
  2009.            Example : HackList C:\PALMSCAN\PALMSCAN.HCK
  2010.  
  2011.  
  2012.       Skip files list
  2013.       ---------------
  2014.  
  2015.       The skip files list can be used to make PalmScan skip certain files.
  2016.       Both normal file-specifications and directories with file-
  2017.       specifications can be used in the skip files list.
  2018.  
  2019.       Example   :    C:\PALMSCAN\PALMSCAN.SKP
  2020.  
  2021.       Keyword   :    SkipFilesList [d:\path\filename.ext]
  2022.  
  2023.            [d:\path\filename.ext]   This is the full path and filename of
  2024.                                     the skip files list to use.
  2025.  
  2026.            Example   :    SkipFilesList C:\PALMSCAN\PALMSCAN.SKP
  2027.  
  2028.  
  2029.       Pack Unpacked files list
  2030.       ------------------------
  2031.  
  2032.       PalmScan will pack all files which are not yet archived, which are
  2033.       specified in this list.
  2034.  
  2035.       Example   :    C:\PALMSCAN\PALMSCAN.PCK
  2036.  
  2037.       Keyword   :    PackUnpackedFilesList [d:\path\filename.ext]
  2038.  
  2039.            [d:\path\filename.ext]   This is the full path and filename of
  2040.                                     the pack unpacked files list to use.
  2041.  
  2042.            Example   :    PackUnpackedFilesList C:\PALMSCAN\PALMSCAN.PCK
  2043.  
  2044.                                       - 33 -
  2045.       PalmScan v2.01                                             User guide
  2046.       ---------------------------------------------------------------------
  2047.  
  2048.       Remove files list
  2049.       -----------------
  2050.  
  2051.       With this list, you can tell PalmScan to remove certain files from
  2052.       archives. For example, this can be used to remove other bbs's
  2053.       advertisements.
  2054.  
  2055.       Example   :    C:\PALMSCAN\PALMSCAN.RMV
  2056.  
  2057.       Keyword   :    RemoveFilesList [d:\path\filename.ext]
  2058.  
  2059.            [d:\path\filename.ext]   This is the full path and filename of
  2060.                                     the remove files list to use.
  2061.  
  2062.            Example   :    RemoveFilesList C:\PALMSCAN\PALMSCAN.RMV
  2063.  
  2064.  
  2065.       Add files list
  2066.       --------------
  2067.  
  2068.       In this list, files which must be added to archives can be
  2069.       configured. File-specifications are not allowed in this list, only
  2070.       path\filenames.
  2071.  
  2072.       Example   :    C:\PALMSCAN\PALMSCAN.ADD
  2073.  
  2074.       Keyword   :    AddFilesList [d:\path\filename.ext]
  2075.  
  2076.            [d:\path\filename.ext]   This is the full path and filename of
  2077.                                     the add files list to use.
  2078.  
  2079.            Example   :    AddFilesList C:\PALMSCAN\PALMSCAN.ADD
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.                                       - 34 -
  2108.       PalmScan v2.01                                             User guide
  2109.       ---------------------------------------------------------------------
  2110.  
  2111.       3.3.5  Message System
  2112.       ---------------------
  2113.  
  2114.       In this section, the PalmScan message system can be configured.
  2115.  
  2116.       Because of the large code size consumption, the message system has
  2117.       been placed in an overlay file (PALMSCAN.OVR). If you do not use the
  2118.       message system and have a shortage of disk space, the overlay file
  2119.       can be removed. The OS/2 version of PalmScan does not use an overlay.
  2120.       Memory limits aren't a problem in that version.
  2121.  
  2122.       At the moment of the v2.01 release, the OS/2 version does not support
  2123.       Ezycom messagebases. A free upgrade will be made available as soon as
  2124.       possible.
  2125.  
  2126.  
  2127.       Net address
  2128.       -----------
  2129.  
  2130.       Here you can specify you main network address, as installed in your
  2131.       mailer configuration. This is only used for messages created when bad
  2132.       or infected archives are found. If you don't have any network
  2133.       address, you don't have to enter anything here either.
  2134.  
  2135.       Example   :    2:2802/140
  2136.  
  2137.       Keyword   :    NetAddress [Zone:Net/Node<.Point>]
  2138.  
  2139.            [Zone:Net/Node<.Point>]  Your network address. 
  2140.                                     <.Point> is optional.
  2141.  
  2142.            Example   :    NetAddress 2:2802/140
  2143.  
  2144.  
  2145.       Messagebase path
  2146.       ----------------
  2147.  
  2148.       When an infected file or a bad archive has been found, PalmScan can
  2149.       post a message to the system operator, describing which archive
  2150.       contains infected file(s), which scanner(s) reported this, what
  2151.       action has been taken and which user was online at the time (when
  2152.       running in online mode). In addition to this, reports created by the
  2153.       virus scanner(s) which detected one or more virus(es) can be added to
  2154.       the message.
  2155.       By specifying a message area, this feature is enabled. When no
  2156.       message area is configured here, the message system is disabled.
  2157.  
  2158.       Example   :    C:\BBS\MSGBASE
  2159.  
  2160.       Keyword   :    MessageArea [Type]<Number>[Path]
  2161.  
  2162.            For more information about the MessageArea keyword, please read
  2163.            the section about that keyword.
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.                                       - 35 -
  2171.       PalmScan v2.01                                             User guide
  2172.       ---------------------------------------------------------------------
  2173.  
  2174.       Messagebase format
  2175.       ------------------
  2176.  
  2177.       When using the message system, PalmScan has to know what kind of
  2178.       messagebase you want it to use. Here you can select the messagebase
  2179.       format.
  2180.  
  2181.       Example   :    Hudson
  2182.  
  2183.       Keyword   :    MessageArea [Type]<Number>[Path]
  2184.  
  2185.            For more information about the MessageArea keyword, please read
  2186.            the section about that keyword.
  2187.  
  2188.  
  2189.       Message area number
  2190.       -------------------
  2191.  
  2192.       When using a Hudson or Ezycom messagebase, a message area number must
  2193.       be configured also. For Fido, Squish and JAM areas, this isn't
  2194.       needed.
  2195.  
  2196.       Example   :    1
  2197.  
  2198.       Keyword   :    MessageArea [Type]<Number>[Path]
  2199.  
  2200.            For more information about the MessageArea keyword, please read
  2201.            the section about that keyword.
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.                                       - 36 -
  2234.       PalmScan v2.01                                             User guide
  2235.       ---------------------------------------------------------------------
  2236.  
  2237.       MessageArea configuration keyword
  2238.       ---------------------------------
  2239.  
  2240.       The MessageArea configuration keyword combines the previous three
  2241.       configuration fields.
  2242.  
  2243.       PalmScan supports these messagebase types:
  2244.  
  2245.       Fido           :    F followed by the message path.
  2246.                           Example : FC:\FD\NETMAIL
  2247.  
  2248.       Hudson         :    H followed by a 3 digit area number followed by
  2249.                           the messagebase path.
  2250.                           Example : H001C:\SBBS\MSGBASE
  2251.  
  2252.       Squish         :    S followed by the full path and filename of the
  2253.                           message area.
  2254.                           Example : SC:\MAX\MSG\PALMSCAN
  2255.  
  2256.       Ezycom 1.02    :    E followed by the 4 digit area number followed by
  2257.                           the messagebase path.
  2258.                           Example : E0001C:\EZY\MSGBASE
  2259.  
  2260.       Ezycom 1.10    :    Z followed by the 4 digit area number followed by
  2261.                           the messagebase path.
  2262.                           Example : Z0001C:\EZY\MSGBASE
  2263.  
  2264.       JAM            :    J followed by the full path and filename of the
  2265.                           message area.
  2266.                           Example : JC:\RA\MSG\PALMSCAN
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.                                       - 37 -
  2297.       PalmScan v2.01                                             User guide
  2298.       ---------------------------------------------------------------------
  2299.  
  2300.       3.3.6  File-database
  2301.       --------------------
  2302.  
  2303.       File-database
  2304.       -------------
  2305.  
  2306.       PalmScan has full support for the RemoteAccess, Ezycom and Concord
  2307.       file-databases. With this option, the file-database feature can be
  2308.       enabled.
  2309.  
  2310.       Example   :    RemoteAccess
  2311.  
  2312.       Keyword   :    FDB [RA|Ezycom|Concord]
  2313.  
  2314.            [RA]      PalmScan will use the RemoteAccess 2.xx file-database.
  2315.                      When an infected file is found, PalmScan will use the
  2316.                      normal procedure to either move the file or exit with
  2317.                      an errorlevel, and besides that it will mark the file
  2318.                      as deleted, unlisted and/or not available, according
  2319.                      to the settings in the RemoteAccess configuration.
  2320.                      When an archive cannot be unpacked, PalmScan will also
  2321.                      use the normal procedure, and it will mark the file as
  2322.                      not available in the file-database.
  2323.  
  2324.            [Ezycom]  PalmScan will use the Ezycom 1.02 or 1.10
  2325.                      file-database. PalmScan will detect the used version
  2326.                      when reading the Ezycom configuration.
  2327.                      When a bad archive (infected, cannot be unpacked,
  2328.                      etc.) is found, PalmScan will use the normal procedure
  2329.                      to either move the file or exit with an errorlevel,
  2330.                      and it will mark the file as offline in the Ezycom
  2331.                      file-database.
  2332.                      When the FileID keyword is used with Ezycom 1.02,
  2333.                      PalmScan will filter out all ascii control codes and
  2334.                      all high ascii, and place the first non-empty line at
  2335.                      the description in the Ezycom file-database. When
  2336.                      using it with Ezycom 1.10, all description
  2337.                      manipulation features are available.
  2338.  
  2339.            [Concord] PalmScan will use the Concord file-database.
  2340.                      When a bad archive (infected, cannot be unpacked,
  2341.                      etc.) is found, PalmScan will use the normal procedure
  2342.                      to either move the file or exit with an errorlevel,
  2343.                      and besides that it will mark the file as deleted,
  2344.                      unlisted and offline.
  2345.  
  2346.            Example   :    FDB RA
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.                                       - 38 -
  2360.       PalmScan v2.01                                             User guide
  2361.       ---------------------------------------------------------------------
  2362.  
  2363.       To prevent problems, here is some inside information about the file-
  2364.       database feature:
  2365.       *    When you are using one directory for different file areas,
  2366.            PalmScan will always use the FIRST area which uses that
  2367.            directory.
  2368.       *    When PalmScan adds a description to the file-database, the old
  2369.            description will not be removed from the database text. It will
  2370.            not be used for the file anymore, but will remain on your disk.
  2371.            To remove the old description you should use the maintenance
  2372.            utility included in your bbs package (for more information,
  2373.            consult your bbs manual).
  2374.       *    When PalmScan adds an unlisted file to the RemoteAccess file-
  2375.            database, it will add the default settings found in the file-
  2376.            area configuration.
  2377.  
  2378.  
  2379.       Uploader name
  2380.       -------------
  2381.  
  2382.       By default, PalmScan uses 'PalmScan' and the version number as
  2383.       uploader name for files added to the RemoteAccess/Ezycom/Concord
  2384.       file-database. With this option, you can specify an other name to use
  2385.       as uploader name.
  2386.  
  2387.       Example   :    Steven Hendriks
  2388.  
  2389.       Keyword   :    UploaderName [Name]
  2390.  
  2391.            [Name]         The name to be used as uploader name.
  2392.  
  2393.            Example   :    UploaderName Steven Hendriks
  2394.  
  2395.       Note      :    This is a bonus feature, which is available in the
  2396.                      registered version only.
  2397.  
  2398.  
  2399.       BBS system directory
  2400.       --------------------
  2401.  
  2402.       When using the RemoteAccess/Ezycom/Concord file-database, PalmScan
  2403.       has to read some information from the RemoteAccess/Ezycom/Concord
  2404.       configuration. Either the RA/EZY/CONCORD environment variable or this
  2405.       keyword must be configured to be able to use the file-database.
  2406.  
  2407.       Example   :    C:\BBS
  2408.  
  2409.       Keyword   :    BBSpath [d:\path]
  2410.  
  2411.            [d:\path]      The bbs system directory.
  2412.  
  2413.            Example   :    BBSpath C:\BBS
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.                                       - 39 -
  2423.       PalmScan v2.01                                             User guide
  2424.       ---------------------------------------------------------------------
  2425.  
  2426.       Update FILES.BBS 
  2427.       ----------------
  2428.  
  2429.       When this option is set, PalmScan will update the entry in the
  2430.       FILES.BBS files list when archive conversion is done, and, in
  2431.       cooperation with the FileID importing function, put the description
  2432.       of the file in this files list.
  2433.  
  2434.       Example   :    X
  2435.  
  2436.       Keyword   :    FilesBBS [c]
  2437.  
  2438.            [c]            For using extended descriptions (descriptions
  2439.                           consisting of multiple lines), PalmScan should
  2440.                           know the character which is used by you BBS
  2441.                           system for this option. SuperBBS uses '>',
  2442.                           RemoteAccess 1.xx uses '+'. By default, no
  2443.                           extended descriptions character is used.
  2444.  
  2445.            Example   :    FilesBBS >
  2446.  
  2447.  
  2448.       Extended descriptions character
  2449.       -------------------------------
  2450.  
  2451.       When using a FILES.BBS files list, and descriptions which cover more
  2452.       than one line are used, an extended descriptions character can be
  2453.       used. This character is placed before each additional description
  2454.       line.
  2455.  
  2456.       Example   :    +
  2457.  
  2458.       Keyword   :    FilesBBS [c]
  2459.  
  2460.            [c]            For using extended descriptions (descriptions
  2461.                           consisting of multiple lines), PalmScan should
  2462.                           know the character which is used by you BBS
  2463.                           system for this option. SuperBBS uses '>',
  2464.                           RemoteAccess 1.xx uses '+'. By default, no
  2465.                           extended descriptions character is used.
  2466.  
  2467.            Example   :    FilesBBS >
  2468.  
  2469.            Note      :    When no extended descriptions character is used,
  2470.                           PalmScan cannot remove extended descriptions when
  2471.                           adding a new description.
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.                                       - 40 -
  2486.       PalmScan v2.01                                             User guide
  2487.       ---------------------------------------------------------------------
  2488.  
  2489.       Spaces to indent
  2490.       ----------------
  2491.  
  2492.       With this option, you can set the number of spaces that should be
  2493.       indented in the FILES.BBS, before extended descriptions.
  2494.  
  2495.       Example   :    1
  2496.  
  2497.       KeyWord   :    IndentSpaces [nn]
  2498.  
  2499.            [nn]           The number of spaces to indent.
  2500.  
  2501.            Example   :    IndentSpaces 1
  2502.  
  2503.  
  2504.       Download counters
  2505.       -----------------
  2506.  
  2507.       When a file which was not already listed has been added to the
  2508.       FILES.BBS files list, and when an extended description has been
  2509.       added, PalmScan will also update the download counter when this
  2510.       option has been configured.
  2511.  
  2512.       Example   :    [ ] 3
  2513.  
  2514.       Keyword   :    DownloadCounter [l] [r] [nnn]
  2515.  
  2516.            [l]            This is the character that is being used as left
  2517.                           bracket in the download counters.
  2518.  
  2519.            [r]            This is the character that is being used as right
  2520.                           bracket in the download counters.
  2521.  
  2522.            [nnn]          This is the number of characters (numbers) that
  2523.                           should be used in between the brackets.
  2524.  
  2525.            Example   :    DownloadCounter [ ] 3
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.                                       - 41 -
  2549.       PalmScan v2.01                                             User guide
  2550.       ---------------------------------------------------------------------
  2551.  
  2552.       FILES.BBS Filename
  2553.       ------------------
  2554.  
  2555.       By default, PalmScan will use the file FILES.BBS in the same
  2556.       directory as the processed files, when the FILES.BBS feature is used.
  2557.       With this option, you can configure the filename for this files list.
  2558.       When it is configured to another name than FILES.BBS, PalmScan will
  2559.       first try this file, and if that fails it will still use the normal
  2560.       FILES.BBS. This option can be used for 4DOS DESCRIPT.ION files, or
  2561.       when you have your files list in a sub-directory of the directory
  2562.       where the files are located. When the latter is used, PalmScan will
  2563.       use this sub-directory for the files list, and when the sub-directory
  2564.       does not exist, the normal FILES.BBS will be used.
  2565.  
  2566.       Example   :    DESCRIPT.ION
  2567.  
  2568.       Keyword   :    FilesBBSname [<path\>filename.ext]
  2569.  
  2570.            [<path\>filename.ext]    The filename of the FILES.BBS file to
  2571.                                     use. <path\> is optional.
  2572.  
  2573.            Example   :    FilesBBSname DESCRIPT.ION
  2574.  
  2575.  
  2576.       Online Import
  2577.       -------------
  2578.  
  2579.       When running online under Concord, Ezycom or Filedoor, PalmScan can
  2580.       place the description in a temporary file, which will then be used by
  2581.       Concord, Ezycom or FileDoor.
  2582.       To use this feature with Ezycom, the node on which PalmScan is
  2583.       running must be specified on the commandline with the /N[node]
  2584.       commandline option.
  2585.       The FILE_ID import function must be used in the PalmScan
  2586.       configuration for this feature to work. The OneLine, Filter, FiltLow
  2587.       and FiltDraw options also work with this function.
  2588.       The Ezycom or Concord file-database feature should not be used with
  2589.       this, or the /NoFDB commandline option should be used, while the bbs
  2590.       program will update the file-database itself.
  2591.       When using the Filedoor online import feature, PalmScan will also
  2592.       inform Filedoor of the changes in filesizes and filenames.
  2593.  
  2594.       When running in local-only mode (/L commandline option), PalmScan
  2595.       will never create the temporary description file.
  2596.  
  2597.       Example   :    Concord
  2598.  
  2599.       Keyword   :    Online [Concord|Ezycom|Filedoor]
  2600.  
  2601.            [Concord]      Use the Concord file_id.diz importing function.
  2602.  
  2603.            [Ezycom]       Use the Ezycom file_id.<node> importing function.
  2604.  
  2605.            [Filedoor]     Use the Filedoor description importing function.
  2606.  
  2607.            Example   :    Online Concord
  2608.  
  2609.  
  2610.  
  2611.                                       - 42 -
  2612.       PalmScan v2.01                                             User guide
  2613.       ---------------------------------------------------------------------
  2614.  
  2615.       3.3.7  Miscellaneous
  2616.       --------------------
  2617.  
  2618.       Log file
  2619.       --------
  2620.  
  2621.       PalmScan can keep track of its activity in a logfile. When this
  2622.       option is not used, no logging will be done.
  2623.  
  2624.       Example   :    C:\LOG\PALMSCAN.LOG
  2625.  
  2626.       Keyword   :    LogFile [d:\path\filename.ext] <Compact|Expanded>
  2627.  
  2628.            [d:\path\filename.ext]   This is the full path and filename of
  2629.                                     the logfile PalmScan should maintain.
  2630.                                     When running on a multi-node system,
  2631.                                     PalmScan can use different log files
  2632.                                     for different nodes. %N in the log
  2633.                                     filename will be replaced by the node
  2634.                                     number on which PalmScan is running
  2635.                                     (this node number must be specified
  2636.                                     with the /N commandline option).
  2637.                                     When only a filename (no path) is
  2638.                                     configured, PalmScan will put the log
  2639.                                     file in the same directory as where
  2640.                                     PalmScan.Exe is located.
  2641.  
  2642.            Example   :    LogFile C:\LOG\PALMSCAN.LOG
  2643.  
  2644.  
  2645.       Log style
  2646.       ---------
  2647.  
  2648.       The log file created by PalmScan can be written in two styles:
  2649.  
  2650.       Compact   :    ----------  Sun 07 Jan 96, PalmScan ...
  2651.                      $ 12:34:56  Local operation
  2652.  
  2653.       Expanded  :    $ 07-Jan 12:34:56 PSCN PalmScan ...
  2654.                      $ 07-Jan 12:34:56 PSCN Local operation
  2655.  
  2656.       Example   :    Expanded
  2657.  
  2658.       Keyword   :    LogFile [d:\path\filename.ext] <Compact|Expanded>
  2659.  
  2660.            <Compact>      This is the default log style.
  2661.  
  2662.            <Expanded>     This is the alternative log style.
  2663.  
  2664.            Example   :    LogFile C:\LOG\PSCAN%N.LOG Expanded
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.                                       - 43 -
  2675.       PalmScan v2.01                                             User guide
  2676.       ---------------------------------------------------------------------
  2677.  
  2678.       No disk space check
  2679.       -------------------
  2680.  
  2681.       Before copying and unpacking files, PalmScan will first check for the
  2682.       available disk space. If it is not sufficient, the operation is
  2683.       cancelled. However, on large partitions (above 2 GB), DOS could
  2684.       return an incorrect value, which could result in incorrect behaviour
  2685.       by PalmScan. To avoid this problem, the disk space check can be
  2686.       disabled.
  2687.       Disabling the disk space check will result in some speed reduction
  2688.       when there is not enough space available (PalmScan will find out
  2689.       while copying / unpacking a file).
  2690.  
  2691.       Example   :    X
  2692.  
  2693.       Keyword   :    NoDiskSpaceCheck
  2694.  
  2695.            Example   :    NoDiskSpaceCheck
  2696.  
  2697.  
  2698.       Exec timeout
  2699.       ------------
  2700.  
  2701.       With this option a timeout value for external programs can be
  2702.       configured. When an external program (like an archiver, virus
  2703.       scanner, etcetera) exceeds this time, PalmScan assumes it hangs, and
  2704.       terminates the process in which the external program is running.
  2705.       The default timeout value is 600 seconds. So when a program takes
  2706.       longer than 10 minutes, PalmScan will terminate it. The minimum value
  2707.       is 60 seconds.
  2708.       Please note that this value should not be set too low, while a
  2709.       program still needs some time to do it's job.
  2710.       This feature is available in the OS/2 version only, while DOS does
  2711.       not support multi-threaded programs.
  2712.  
  2713.       Example   :    600
  2714.  
  2715.       Keyword   :    ExecTimeOut [seconds]
  2716.  
  2717.            [seconds]      The number of seconds before PalmScan should
  2718.                           terminate the external program.
  2719.  
  2720.            Example   :    ExecTimeOut 600.
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.                                       - 44 -
  2738.       PalmScan v2.01                                             User guide
  2739.       ---------------------------------------------------------------------
  2740.  
  2741.       3.4  File Processing
  2742.       --------------------
  2743.  
  2744.       3.4.1  General settings
  2745.       -----------------------
  2746.  
  2747.       Only process new files
  2748.       ----------------------
  2749.  
  2750.       For running PalmScan in a daily event, it's possible to process only
  2751.       new files. PalmScan can use three methods to determine whether a file
  2752.       is new:
  2753.  
  2754.       Archive Attr   When this option is used, PalmScan will only process
  2755.                      files with the archive attribute set, and remove this
  2756.                      attribute when a file has been processed, thus
  2757.                      processing files only once.
  2758.  
  2759.       FileDate       In this case, PalmScan will only process files which
  2760.                      have a file date and time later than the last time a
  2761.                      file has been processed in that directory. PalmScan
  2762.                      will store the date in a file called LASTSCAN.PS, in
  2763.                      the directory where the file was found.
  2764.                      Because LASTSCAN.PS only contains the last date and
  2765.                      time a file has been processed, it will affect the
  2766.                      processing of ALL files in that directory.
  2767.                      This method will use a directory entry (0-byte file)
  2768.                      for each processed directory.
  2769.  
  2770.       DataFile       In this case, PalmScan will only process files which
  2771.                      are not found in the data file, and files with a
  2772.                      changed size, date or time. The file which is used to
  2773.                      store the data is called PALMSCAN.DAT. PalmScan uses
  2774.                      separate datafiles for separate directory's, so when a
  2775.                      file is being moved, it will also be processed.
  2776.                      This method uses 12 bytes of disk space for each
  2777.                      processed file (and a directory entry in each
  2778.                      processed directory).
  2779.  
  2780.                      The DataFile method is the most secure method; The
  2781.                      archive attribute method fails on systems where the
  2782.                      archive attribute is being reset by another program
  2783.                      (some backup programs do that), and the file date
  2784.                      method affects complete directory's, where this method
  2785.                      affects only the file which is processed.
  2786.  
  2787.       Example   :    Data File
  2788.  
  2789.       Keyword   :    OnlyNewFiles <FileDate|DataFile>
  2790.  
  2791.            <FileDate>     Use the File Date method.
  2792.  
  2793.            <DataFile>     Use the Data File method.
  2794.  
  2795.            When no method is specified, PalmScan will use the archive
  2796.            attribute method.
  2797.  
  2798.            Example   :    OnlyNewFiles DataFile
  2799.  
  2800.                                       - 45 -
  2801.       PalmScan v2.01                                             User guide
  2802.       ---------------------------------------------------------------------
  2803.  
  2804.       Only process listed files
  2805.       -------------------------
  2806.  
  2807.       By default, all files which comply with the given file specifications
  2808.       (and are not specified with in the Skip files list) will be
  2809.       processed. With this keyword, you can tell PalmScan to only process
  2810.       files which are listed in the FILES.BBS files list (when the
  2811.       FILES.BBS feature is used) and/or the RemoteAccess/Ezycom/Concord
  2812.       file-database (when the file-database feature is used).
  2813.  
  2814.       Example   :    X
  2815.  
  2816.       Keyword   :    ProcessListedOnly
  2817.  
  2818.            Example   :    ProcessListedOnly
  2819.  
  2820.       Note      :    This is a bonus feature, which is available in the
  2821.                      registered version only.
  2822.  
  2823.  
  2824.       Process embedded archives
  2825.       -------------------------
  2826.  
  2827.       PalmScan has the ability to process embedded archives. With this
  2828.       statement you can enable this feature. When there isn't enough memory
  2829.       available to start processing an embedded archive, PalmScan will swap
  2830.       itself to XMS, EMS or disk, and startup another copy of itself. The
  2831.       OS/2 version will never startup another copy of itself, while there
  2832.       always is enough memory available.
  2833.       PalmScan will not do some things with those embedded archives, which
  2834.       are done with main archives. It will not add archive headers or move
  2835.       infected or bad archives. When an infected embedded archive has been
  2836.       found, the main archive will be handled as being infected.
  2837.  
  2838.       Example   :    X
  2839.  
  2840.       Keyword   :    ArchInArch
  2841.  
  2842.            Example   :    ArchInArch
  2843.  
  2844.            Note      :    This is the main switch for embedded archive
  2845.                           processing. When this is not used, all
  2846.                           OnlyMainArchive switches will have no meaning.
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.                                       - 46 -
  2864.       PalmScan v2.01                                             User guide
  2865.       ---------------------------------------------------------------------
  2866.  
  2867.       New archive date
  2868.       ----------------
  2869.  
  2870.       When an archive has been processed, PalmScan can touch the file date
  2871.       and time on the archive. These options are available:
  2872.  
  2873.       Original            :    The processed archive will get the same date
  2874.                                and time as the original archive. This is
  2875.                                the default setting.
  2876.  
  2877.       Today               :    The processed archive will get the current
  2878.                                date and time.
  2879.  
  2880.       Latest              :    The processed archive will get the date and
  2881.                                time of the latest (newest) file in the
  2882.                                archive.
  2883.  
  2884.       Oldest              :    The processed archive will get the date and
  2885.                                time of the oldest file in the archive.
  2886.  
  2887.       Reset future dates  :    The processed archive will get today's date
  2888.                                only when the original archive's date is a
  2889.                                future date. When the original archive's
  2890.                                date is a correct (older) date, the new
  2891.                                archive will get the same date as the
  2892.                                original archive.
  2893.  
  2894.       Example   :    Reset future dates
  2895.  
  2896.       Keyword   :    Touch <Original|Today|Latest|Oldest|ResetFuture>
  2897.  
  2898.            <Original>     The processed archive will get the same date and
  2899.                           time as the original archive. This is the default
  2900.                           setting.
  2901.  
  2902.            <Today>        The processed archive will get the current date
  2903.                           and time.
  2904.  
  2905.            <Latest>       The processed archive will get the date and time
  2906.                           of the latest (newest) file in the archive.
  2907.  
  2908.            <Oldest>       The processed archive will get the date and time
  2909.                           of the oldest file in the archive.
  2910.  
  2911.            <ResetFuture>  The processed archive will get today's date only
  2912.                           when the original archive's date is a future
  2913.                           date. When the original archive's date is a
  2914.                           correct (older) date, the new archive will get
  2915.                           the same date as the original archive.
  2916.  
  2917.            Example   :    Touch ResetFuture
  2918.  
  2919.       Note      :    This is a bonus feature, which is available in the
  2920.                      registered version only.
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.                                       - 47 -
  2927.       PalmScan v2.01                                             User guide
  2928.       ---------------------------------------------------------------------
  2929.  
  2930.       3.4.2  Archive Conversion
  2931.       -------------------------
  2932.  
  2933.       Archive conversion
  2934.       ------------------
  2935.  
  2936.       This option sets the target archive system. When no target archive
  2937.       system is set, no archive conversion will be done. The archive system
  2938.       configured here, must also be configured at the archivers section.
  2939.  
  2940.       Example   :    RAR
  2941.  
  2942.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  2943.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  2944.  
  2945.            For more information about the ArchiveConversion keyword, please
  2946.            read the section about that keyword.
  2947.  
  2948.  
  2949.       SFX
  2950.       ---
  2951.  
  2952.       When converting archives to self-extracting archives, this switch
  2953.       should be used. PalmScan will then use .EXE as the extension instead
  2954.       of the default extension which is configured for that archiver.
  2955.  
  2956.       Example   :    X
  2957.  
  2958.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  2959.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  2960.  
  2961.            For more information about the ArchiveConversion keyword, please
  2962.            read the section about that keyword.
  2963.  
  2964.       Note      :    This is a bonus feature, which is available in the
  2965.                      registered version only.
  2966.  
  2967.  
  2968.       Only Main Archives
  2969.       ------------------
  2970.  
  2971.       When this switch is selected, only  main archives will be converted
  2972.       to the target archive type. Embedded archives will still be processed
  2973.       for other options when the embedded archive processing is enabled,
  2974.       but those archives will not be converted.
  2975.  
  2976.       Example   :    Only Main Archives
  2977.  
  2978.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  2979.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  2980.  
  2981.            For more information about the ArchiveConversion keyword, please
  2982.            read the section about that keyword.
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.                                       - 48 -
  2990.       PalmScan v2.01                                             User guide
  2991.       ---------------------------------------------------------------------
  2992.  
  2993.       Don't convert secure archives
  2994.       -----------------------------
  2995.  
  2996.       When this switch is used, secure archives (archives with a security
  2997.       envelope, authenticity verification or seal) will not be converted,
  2998.       no files will be removed or added, no music modules will be
  2999.       described, and an archive header will not be added to secured ARJ and
  3000.       UC2 archives. Also, the archives embedded in secure archives will not
  3001.       be altered in any way.
  3002.       PalmScan can detect ARJ security envelopes, ZIP and RAR authenticity
  3003.       verifications and UC2 seals.
  3004.  
  3005.       Example   :    X
  3006.  
  3007.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  3008.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  3009.  
  3010.            For more information about the ArchiveConversion keyword, please
  3011.            read the section about that keyword.
  3012.  
  3013.       Note      :    This is a bonus feature, which is available in the
  3014.                      registered version only.
  3015.  
  3016.  
  3017.       Only convert embedded archives with normal extensions
  3018.       -----------------------------------------------------
  3019.  
  3020.       When this switch is used, PalmScan will only convert embedded
  3021.       archives which have a normal extension. This can be useful for
  3022.       archives which contain an installation program, which then uses the
  3023.       embedded archives to install a software product. Usually, those
  3024.       embedded archives do not have a normal extension, so they will not be
  3025.       converted by PalmScan when this option is used.
  3026.       The main archive will be converted as usual.
  3027.  
  3028.       Example   :    X
  3029.  
  3030.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  3031.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  3032.  
  3033.            For more information about the ArchiveConversion keyword, please
  3034.            read the section about that keyword.
  3035.  
  3036.       Note      :    This is a bonus feature, which is available in the
  3037.                      registered version only.
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.                                       - 49 -
  3053.       PalmScan v2.01                                             User guide
  3054.       ---------------------------------------------------------------------
  3055.  
  3056.       ArchiveConversion configuration keyword
  3057.       ---------------------------------------
  3058.  
  3059.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  3060.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  3061.  
  3062.            [Archiver]     This sets the target. You can supply all values
  3063.                           you configured with the Archiver statement.
  3064.  
  3065.            <OnlyMainArchive>             Do not convert embedded archives.
  3066.  
  3067.            <NoSFX>                       Do not convert self-extracting
  3068.                                          archives.
  3069.  
  3070.            <NoSecure>                    Do not convert secure archives.
  3071.  
  3072.            <ToSFX>                       The selected archiver creates
  3073.                                          self-extracting archives.
  3074.  
  3075.            <EmbeddedOnlyNormalNames>     Only convert embedded archives
  3076.                                          which have a normal extension.
  3077.  
  3078.            Example   :    ArchiveConversion RAR OnlyMainArchive NoSecure
  3079.  
  3080.  
  3081.       Convert ALL archives
  3082.       --------------------
  3083.  
  3084.       Normally, PalmScan will only convert archives of other types than the
  3085.       target archive system. With this option you can tell PalmScan to
  3086.       convert all archives, even if it's already of the target archive
  3087.       type.
  3088.       When Only Main Archives is selected, only main archives which are
  3089.       already in the target archive type will be converted. Embedded
  3090.       archives which are already in the target archive will not be
  3091.       converted.
  3092.  
  3093.       Example   :    Yes
  3094.  
  3095.       Keyword   :    ConvertAll <OnlyMainArchive>
  3096.  
  3097.            <OnlyMainArchive>   Only convert main archives which are already
  3098.                                in the target format.
  3099.  
  3100.            Example   :    ConvertAll OnlyMainArchive
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.                                       - 50 -
  3116.       PalmScan v2.01                                             User guide
  3117.       ---------------------------------------------------------------------
  3118.  
  3119.       3.4.3  Self-Extracting Archives
  3120.       -------------------------------
  3121.  
  3122.       Process SFX archives
  3123.       --------------------
  3124.  
  3125.       By default, self-extracting (SFX) archives, are not recognised as
  3126.       being archives. With this switch, you can tell PalmScan to process
  3127.       self-extracting archives, just like every other archive. PalmScan can
  3128.       detect ZIP, LZH, SQZ, ARJ, PAK, RAR and UC2 self-extracting archives.
  3129.  
  3130.       Example   :    X
  3131.  
  3132.       Keyword   :    ProcessSFX
  3133.  
  3134.            Example : ProcessSFX
  3135.  
  3136.  
  3137.       Do not convert self-extracting archives
  3138.       ---------------------------------------
  3139.  
  3140.       When this switch is specified, self-extracting archives will not be
  3141.       converted to the target archive type, and no files will be removed
  3142.       from those archives. Also, embedded archives will not be altered.
  3143.  
  3144.       Example   :    X
  3145.  
  3146.       Keyword   :    ArchiveConversion [Archiver] <OnlyMainArchive> <NoSFX>
  3147.                      <NoSecure> <ToSFX> <EmbeddedOnlyNormalNames>
  3148.  
  3149.            For more information about the ArchiveConversion keyword, please
  3150.            read the section about that keyword.
  3151.  
  3152.  
  3153.       Process UC2 self-extracting archives
  3154.       ------------------------------------
  3155.  
  3156.       While UC2 itself (UC.EXE) cannot unpack them, UC2 self-extracting
  3157.       archives have to be executed to extract files from it. By default,
  3158.       PalmScan will not unpack UC2 SFX archives. The reason is simple, it's
  3159.       just not safe (the file can be infected by viruses, or it could be a
  3160.       trojan). To make PalmScan unpack UC2 SFX archives, this switch must
  3161.       be used.
  3162.  
  3163.       When one or more virus scanner(s) have been configured (Scanner
  3164.       keyword), and *.EXE or anything implying *.EXE should be scanned
  3165.       (VirusScan keyword), PalmScan will scan the UC2 self-extracting
  3166.       archive for viruses before it will be unpacked.
  3167.  
  3168.       Example   :    X
  3169.  
  3170.       Keyword   :    UC2SFX [Commandline] <SecureOnly>
  3171.  
  3172.            For more information about the UC2SFX keyword, please read the
  3173.            section about that keyword.
  3174.  
  3175.  
  3176.  
  3177.  
  3178.                                       - 51 -
  3179.       PalmScan v2.01                                             User guide
  3180.       ---------------------------------------------------------------------
  3181.  
  3182.       UC2 SFX commandline options
  3183.       ---------------------------
  3184.  
  3185.       The commandline which should be passed on to the UC2 self-extracting
  3186.       archive (.EXE), when executing it, must be configured here when the
  3187.       Process UC2 self-extracting archives option has been enabled.
  3188.  
  3189.       Example   :    -o .
  3190.  
  3191.       Keyword   :    UC2SFX [Commandline] <SecureOnly>
  3192.  
  3193.            For more information about the UC2SFX keyword, please read the
  3194.            section about that keyword.
  3195.  
  3196.  
  3197.       Only process sealed UC2 self-extracting archives
  3198.       ------------------------------------------------
  3199.  
  3200.       When this option is used, PalmScan will only unpack (execute) UC2
  3201.       self-extracting archives which have been sealed.
  3202.  
  3203.       Example   :    X
  3204.  
  3205.       Keyword   :    UC2SFX [Commandline] <SecureOnly>
  3206.  
  3207.            For more information about the UC2SFX keyword, please read the
  3208.            section about that keyword.
  3209.  
  3210.       Note      :    This is a bonus feature, which is available in the
  3211.                      registered version only.
  3212.  
  3213.  
  3214.       UC2SFX configuration keyword
  3215.       ----------------------------
  3216.  
  3217.       Keyword   :    UC2SFX [Commandline] <SecureOnly>
  3218.  
  3219.            [Commandline]  The commandline which should be passed on to the
  3220.                           UC2 self-extracting archive (.EXE), when
  3221.                           executing it.
  3222.  
  3223.            <SecureOnly>   When this option is used, PalmScan will only
  3224.                           unpack (execute) UC2 self-extracting archives
  3225.                           which have been sealed.
  3226.  
  3227.  
  3228.            Example : UC2SFX -o_. SecureOnly
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.                                       - 52 -
  3242.       PalmScan v2.01                                             User guide
  3243.       ---------------------------------------------------------------------
  3244.  
  3245.       UC2 SFX seal test command
  3246.       -------------------------
  3247.  
  3248.       When only sealed UC2 SFX archives may be processed, PalmScan can test
  3249.       the seal before the UC2 self-extracting archive will be unpacked. The
  3250.       command to test the seal can be specified here.
  3251.  
  3252.       Example   :    USAFE.EXE
  3253.  
  3254.       Keyword   :    UC2SealTest [Command]
  3255.  
  3256.            [Command] The command to execute to test UC2 seals.
  3257.  
  3258.            Example : UC2SealTest USAFE.EXE
  3259.  
  3260.       Note      :    This is a bonus feature, which is available in the
  3261.                      registered version only.
  3262.  
  3263.  
  3264.       Scan SFX archives for viruses
  3265.       -----------------------------
  3266.  
  3267.       When one or more virus scanner(s) have been configured to scan *.EXE
  3268.       or anything implying *.EXE, and this feature is used, PalmScan will
  3269.       scan all self-extracting archives prior to processing them.
  3270.       When this option is not used, PalmScan will still scan UC2 self-
  3271.       extracting archives will still be scanned (see UC2SFX keyword).
  3272.  
  3273.       Example   :    X
  3274.  
  3275.       Keyword : ScanSFX
  3276.  
  3277.            Example   :    ScanSFX
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.                                       - 53 -
  3305.       PalmScan v2.01                                             User guide
  3306.       ---------------------------------------------------------------------
  3307.  
  3308.       3.4.4  Archive Headers
  3309.       ----------------------
  3310.  
  3311.       Archive header file
  3312.       -------------------
  3313.  
  3314.       PalmScan can add a header to your archives. When this filename points
  3315.       to a valid ASCII textfile, this file will be used as header for the
  3316.       archive.
  3317.  
  3318.       When using UC2 as archiver, PalmScan can also add multimedia headers.
  3319.       The file configured with this option will be added as TXT header. For
  3320.       multimedia headers, you should put the GIF/JPG/MOD/ASK files in the
  3321.       same directory and filename as the configured archive header, and
  3322.       with extension GIF/JPG/MOD/ASK. If you don't want to use the TXT
  3323.       header, but do want to use other headers, you should put the filename
  3324.       of the other headers at the ArchiveHeader keyword without extension
  3325.       or with an extension of a non-existing file (never put GIF/JPG/MOD
  3326.       extensions there, PalmScan will then add these files as archive
  3327.       header as if they were normal text files).
  3328.  
  3329.       Example   :    C:\PALMSCAN\HEADER.ASC
  3330.  
  3331.       Keyword   :    ArchiveHeader [d:\path\filename.ext]
  3332.  
  3333.            [d:\path\filename.ext]   This is the full path and filename to
  3334.                                     the header text file.
  3335.  
  3336.            Example   :    ArchiveHeader C:\PALMSCAN\HEADER.ASC
  3337.  
  3338.  
  3339.       Alternative header file
  3340.       -----------------------
  3341.  
  3342.       Just like with the archive header file option, PalmScan can add this
  3343.       header to your archives. This archive header will only be used with
  3344.       the archive type(s) which have the alternative header switch set.
  3345.       This can be very useful for adding an ANSI header to archives which
  3346.       support it, and add a normal text file to all other archives.
  3347.  
  3348.       Example   :    C:\PALMSCAN\HEADER.ANS
  3349.  
  3350.       Keyword   :    AnsiHeader [d:\path\filename.ext] <Archivers>
  3351.  
  3352.            [d:\path\filename.ext]   This is the full path and filename to
  3353.                                     the header text file.
  3354.  
  3355.            <Archivers>              The archiver(s) with which this archive
  3356.                                     header should be used.
  3357.  
  3358.            Example   :    AnsiHeader C:\PALMSCAN\HEADER.ANS RAR
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.                                       - 54 -
  3368.       PalmScan v2.01                                             User guide
  3369.       ---------------------------------------------------------------------
  3370.  
  3371.       Put FILE_ID description in archive header
  3372.       -----------------------------------------
  3373.  
  3374.       When this switch is on, PalmScan will add the description from
  3375.       FILE_ID.DIZ or DESC.SDI to the archive header. When an archive header
  3376.       is already being added, the description will be appended to it.
  3377.  
  3378.       Example   :    X
  3379.  
  3380.       Keyword   :    FileIDarchiveHdr
  3381.  
  3382.            Example   :    FileIDarchiveHdr
  3383.  
  3384.  
  3385.       No title in headers
  3386.       -------------------
  3387.  
  3388.       By default, PalmScan will add it's title to archive headers, when an
  3389.       archive header is added. With this option, you can disable it.
  3390.  
  3391.       Example   :    X
  3392.  
  3393.       Keyword   :    NoTitleInHdr
  3394.  
  3395.            Example   :    NoTitleInHdr
  3396.  
  3397.       Note      :    This is a bonus feature, which is available in the
  3398.                      registered version only.
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.                                       - 55 -
  3431.       PalmScan v2.01                                             User guide
  3432.       ---------------------------------------------------------------------
  3433.  
  3434.       3.4.5  Descriptions
  3435.       -------------------
  3436.  
  3437.       Import FILE_ID description
  3438.       --------------------------
  3439.  
  3440.       When this switch is set, PalmScan will import the description from
  3441.       FILE_ID.DIZ or DESC.SDI file online or to FILES.BBS and/or the file-
  3442.       database.
  3443.  
  3444.       Example   :    X
  3445.  
  3446.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3447.                      <MaxLines=value>
  3448.  
  3449.            For more information about the FileID keyword, please read the
  3450.            section about that keyword.
  3451.  
  3452.  
  3453.       One line FILE_ID
  3454.       ----------------
  3455.  
  3456.       When this switch is enabled, PalmScan will place descriptions from
  3457.       FILE_ID.DIZ or DESC.SDI on one long line, instead of on multiple
  3458.       lines.
  3459.  
  3460.       Example   :    X
  3461.  
  3462.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3463.                      <MaxLines=value>
  3464.  
  3465.            For more information about the FileID keyword, please read the
  3466.            section about that keyword.
  3467.  
  3468.  
  3469.       Filter high ASCII
  3470.       -----------------
  3471.  
  3472.       PalmScan can filter out high ASCII (characters 128 to 255) from
  3473.       FILE_ID.DIZ or DESC.SDI descriptions. When this switch is used, all
  3474.       high ASCII characters will be removed from the description, and empty
  3475.       lines (which can be caused by removing high ASCII characters when a
  3476.       line consists of only those characters) will be removed.
  3477.  
  3478.       Example   :    X
  3479.  
  3480.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3481.                      <MaxLines=value>
  3482.  
  3483.            For more information about the FileID keyword, please read the
  3484.            section about that keyword.
  3485.  
  3486.  
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.                                       - 56 -
  3494.       PalmScan v2.01                                             User guide
  3495.       ---------------------------------------------------------------------
  3496.  
  3497.       Filter control codes
  3498.       --------------------
  3499.  
  3500.       PalmScan can filter out ASCII control-codes (characters 0 to 31) in
  3501.       FILE_ID.DIZ or DESC.SDI descriptions before importing them.
  3502.  
  3503.       Example   :    X
  3504.  
  3505.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3506.                      <MaxLines=value>
  3507.  
  3508.            For more information about the FileID keyword, please read the
  3509.            section about that keyword.
  3510.  
  3511.  
  3512.       Filter drawings
  3513.       ---------------
  3514.  
  3515.       PalmScan can filter out standard ASCII drawings (for which characters
  3516.       within the range 32 to 126 are used) in descriptions. This works a
  3517.       bit different than the control codes and high ASCII filter functions,
  3518.       while not everything should be filtered out. PalmScan detects
  3519.       drawings by looking at character sequences on complete lines.
  3520.  
  3521.       Example   :    X
  3522.  
  3523.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3524.                      <MaxLines=value>
  3525.  
  3526.            For more information about the FileID keyword, please read the
  3527.            section about that keyword.
  3528.  
  3529.  
  3530.       Maximum Width
  3531.       -------------
  3532.  
  3533.       The maximum width of imported descriptions can be configured with
  3534.       this option.
  3535.  
  3536.       Example   :    50
  3537.  
  3538.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3539.                      <MaxLines=value>
  3540.  
  3541.            For more information about the FileID keyword, please read the
  3542.            section about that keyword.
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.                                       - 57 -
  3557.       PalmScan v2.01                                             User guide
  3558.       ---------------------------------------------------------------------
  3559.  
  3560.       Maximum Length
  3561.       --------------
  3562.  
  3563.       The maximum number of lines of imported descriptions can be
  3564.       configured with this option.
  3565.  
  3566.       Example   :    25
  3567.  
  3568.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3569.                      <MaxLines=value>
  3570.  
  3571.            For more information about the FileID keyword, please read the
  3572.            section about that keyword.
  3573.  
  3574.  
  3575.       FileID configuration keyword
  3576.       ----------------------------
  3577.  
  3578.       Keyword   :    FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value>
  3579.                      <MaxLines=value>
  3580.  
  3581.            <OneLine>           Import extended descriptions on one (long)
  3582.                                line.
  3583.  
  3584.            <Filter>            Filter out high ASCII (characters 127-255)
  3585.                                from descriptions when importing them.
  3586.  
  3587.            <FiltLow>           Filter out ASCII control codes (characters
  3588.                                0-31) from descriptions when importing them.
  3589.  
  3590.            <FiltDraw>          Filter out standard ASCII drawings from
  3591.                                descriptions when importing them.
  3592.  
  3593.            <MaxWidth=value>    The maximum width of imported descriptions.
  3594.  
  3595.            <MaxLines=value>    The maximum number of lines of imported
  3596.                                descriptions.
  3597.  
  3598.            Example   :    FileID OneLine Filter FiltLow FiltDraw
  3599.                           MaxWidth=50 MaxLines=25
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.                                       - 58 -
  3620.       PalmScan v2.01                                             User guide
  3621.       ---------------------------------------------------------------------
  3622.  
  3623.       Describe MOD's
  3624.       --------------
  3625.  
  3626.       PalmScan has the ability to describe MOD, NST, STM (ScreamTracker
  3627.       Modules), 669, JMusic and Organ music files. PalmScan will put the
  3628.       description of those files in a FILE_ID.DIZ descriptions file, which
  3629.       will be packed with the other files in the archive. This will only be
  3630.       done when no executables are found in the archive (ie. the archive
  3631.       only consists of music files), or when a FILE_ID.DIZ already exists
  3632.       in the archive (PalmScan will add the descriptions of the music files
  3633.       to this FILE_ID.DIZ in this case). With this keyword, you can enable
  3634.       this option.
  3635.       When Only Main Archives is selected, only modules in the main archive
  3636.       will be described. When embedded archives are being processed,
  3637.       modules in those archives will be ignored. This is only valid when
  3638.       the embedded archive processing is enabled.
  3639.  
  3640.       Example   :    Yes
  3641.  
  3642.       Keyword   :    DescribeMod <OnlyMainArchive>
  3643.  
  3644.            Example : DescribeMod OnlyMainArchive
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.                                       - 59 -
  3683.       PalmScan v2.01                                             User guide
  3684.       ---------------------------------------------------------------------
  3685.  
  3686.       3.5  Archivers
  3687.       --------------
  3688.  
  3689.       The archivers are essential for PalmScan's operation. They are needed
  3690.       to extract files from archives, pack archives, add headers and test
  3691.       archives. This section explains what the commands are used for.
  3692.  
  3693.  
  3694.       3.5.1  Archiver commands
  3695.       ------------------------
  3696.  
  3697.       In the configuration file, every archiver takes up multiple lines.
  3698.       First, there must be an Archiver keyword:
  3699.  
  3700.       Keyword   :    Archiver [ext]
  3701.  
  3702.            [ext]          This is the normal extension of archives created
  3703.                           by this archiver. This will also be used as the
  3704.                           name of the archive within PalmScan.
  3705.  
  3706.            Example   :    ZIP
  3707.  
  3708.       After the Archiver keyword, all commands can be specified. There are
  3709.       several keywords available which must be used to pass on parameters
  3710.       to the archivers:
  3711.  
  3712.       @Archive       Will be replaced by the full path and filename of the
  3713.                      archive which is being processed. When the path and/or
  3714.                      filename contains spaces, PalmScan will add a '"'
  3715.                      (without quotes) before and after the path\filename.
  3716.  
  3717.       @Path          Will be replaced by the directory, without trailing
  3718.                      backlash ('\'), where files should be unpacked to or
  3719.                      packed from. This keyword usually is not necessary
  3720.                      with most archivers, while PalmScan will always make
  3721.                      this directory the current directory before executing
  3722.                      an archiver command.
  3723.  
  3724.       @Filename      Will be replaced by the filename to be unpacked,
  3725.                      packed or added as archive header. This can be either
  3726.                      *.* or a normal filename.
  3727.  
  3728.       @Filenames     Will be replaced by the filenames to be unpacked,
  3729.                      packed or added as archive header. This can be either
  3730.                      *.*, a normal filename, or multiple normal filenames
  3731.                      (separated by spaces). This keyword should never be
  3732.                      used in conjunction with @Path, while only the first
  3733.                      filename would get the path in front of it then. It
  3734.                      should only be used when the archiver supports
  3735.                      multiple filenames on it's commandline.
  3736.  
  3737.       @Size          Will be replaced by the target size when packing a
  3738.                      multi-volume archive. Therefor, this keyword is only
  3739.                      available at the multi-volume compression commands.
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.                                       - 60 -
  3746.       PalmScan v2.01                                             User guide
  3747.       ---------------------------------------------------------------------
  3748.  
  3749.       For each command, there are two versions: A DOS command and an OS/2
  3750.       command. The DOS version of PalmScan will only use the DOS commands.
  3751.       The OS/2 version will use the OS/2 command when configured, and the
  3752.       DOS command when no OS/2 command is available.
  3753.  
  3754.       In the following sections, ZIP will be used as examples at most
  3755.       commands, RAR is used at the multi-volume commands. A complete list
  3756.       of commands is listed at the end of this chapter.
  3757.  
  3758.  
  3759.       Compression
  3760.       -----------
  3761.  
  3762.       This is the full command for the current archiver to compress files.
  3763.  
  3764.       Example   :    pkzip -ex -r -p @Archive @Filenames
  3765.  
  3766.       Keywords  :    Pack [command]
  3767.                      OS2pack [command]
  3768.  
  3769.            Examples  :    Pack pkzip -ex -r -p @Archive @Filenames
  3770.                           OS2pack zip -r -9 -S @Archive @Filenames
  3771.  
  3772.  
  3773.       Decompression
  3774.       -------------
  3775.  
  3776.       This is the full command for the current archiver to extract
  3777.       archives.
  3778.  
  3779.       Example   :    pkunzip -o -d @Archive @Filenames
  3780.  
  3781.       Keywords  :    Unpack [command]
  3782.                      OS2unpack [command]
  3783.  
  3784.            Examples  :    Unpack pkunzip -o -d @Archive @Filenames
  3785.                           OS2unpack unzip -o @Archive @Filenames
  3786.  
  3787.  
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.                                       - 61 -
  3809.       PalmScan v2.01                                             User guide
  3810.       ---------------------------------------------------------------------
  3811.  
  3812.       Add Header
  3813.       ----------
  3814.  
  3815.       This is the full command for the current archiver to add a header to
  3816.       an archive.
  3817.  
  3818.       Example   :    pkzip -z<@Path\@Filename @Archive
  3819.  
  3820.       Keywords  :    Header [command]
  3821.                      OS2header [command]
  3822.  
  3823.            Examples  :    Header pkzip -z<@Path\@Filename @Archive
  3824.                           OS2header zip -z<@Path\@Filename @Archive
  3825.  
  3826.       Besides using it for adding an archive header, this feature can also
  3827.       be used to add an authenticity validation. For example, this can be
  3828.       used for ZIP:
  3829.  
  3830.            Header C:\PALMSCAN\ZIPAV.BAT @Path\@Filename @Archive
  3831.  
  3832.       Where ZIPAV.BAT would contain this:
  3833.  
  3834.            copy C:\PALMSCAN\AVEXTRA.TXT .\
  3835.            pkzip -! -ex -xAVEXTRA.TXT %2
  3836.            pkzip -z<%1 %2
  3837.  
  3838.  
  3839.       Alternative header
  3840.       ------------------
  3841.  
  3842.       Check this switch to use the alternative archive header with this
  3843.       archiver.
  3844.  
  3845.       Example   :    X
  3846.  
  3847.       Keyword   :    AnsiHeader [d:\path\filename.ext] <Archivers>
  3848.  
  3849.            Example   :    AnsiHeader C:\PALMSCAN\HEADER.ANS RAR
  3850.  
  3851.  
  3852.  
  3853.  
  3854.  
  3855.  
  3856.  
  3857.  
  3858.  
  3859.  
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.                                       - 62 -
  3872.       PalmScan v2.01                                             User guide
  3873.       ---------------------------------------------------------------------
  3874.  
  3875.       Test
  3876.       ----
  3877.  
  3878.       When an archive cannot be unpacked, PalmScan will test the archive
  3879.       when a test command has been configured. This can be useful for
  3880.       archives which have been created with another file-system (e.g. HPFS
  3881.       long filenames cannot be unpacked in DOS). Normally, PalmScan will
  3882.       mark those archives as bad, but when the archive test feature is
  3883.       used, it will only be marked as bad when it also fails the archive
  3884.       test.
  3885.  
  3886.       This feature should be used with caution! When an archive cannot be
  3887.       unpacked, and it does pass the archive test, these actions will not
  3888.       be performed:
  3889.       -    Virus scan
  3890.       -    Embedded archive processing
  3891.       -    Old files check will only be done when configured to check the
  3892.            original date
  3893.       -    Removal of unwanted files
  3894.       -    Adding files
  3895.       -    Music files descriptions
  3896.       -    Adding CRC-32 file list
  3897.  
  3898.       In brief, you should only use this feature when necessary. I.e., if
  3899.       you never or hardly ever receive any files which are marked as bad
  3900.       because of the filenames in the archive, you should not use this
  3901.       feature.
  3902.  
  3903.       Example   :    pkzip -t @Archive
  3904.  
  3905.       Keywords  :    Test [command]
  3906.                      OS2test [command]
  3907.  
  3908.            Examples  :    Test pkzip -t @Archive
  3909.                           OS2test zip -T @Archive
  3910.  
  3911.       Note      :    This is a bonus feature, which is available in the
  3912.                      registered version only.
  3913.  
  3914.  
  3915.       Multi-Volume Compression
  3916.       ------------------------
  3917.  
  3918.       This is the full command for the current archiver to create a multi-
  3919.       volume archive.
  3920.  
  3921.       Example   :    rar a -r -y -o- -std -m5 -v@Size @Archive @Filenames
  3922.  
  3923.       Keywords  :    MVpack [command]
  3924.                      OS2MVpack [command]
  3925.  
  3926.            Examples  :    MVpack rar a -r -y -o- -std -m5 -v@Size @Archive
  3927.                           @Filenames
  3928.                           OS2MVpack rar a -r -y -o- -std -m5 -v@Size
  3929.                           @Archive @Filenames
  3930.  
  3931.  
  3932.  
  3933.  
  3934.                                       - 63 -
  3935.       PalmScan v2.01                                             User guide
  3936.       ---------------------------------------------------------------------
  3937.  
  3938.       Multi-Volume Decompression
  3939.       --------------------------
  3940.  
  3941.       This is the full command for the current archiver to unpack multi-
  3942.       volume archives.
  3943.  
  3944.       Example   :    rar x -r -y -o- -std -c- @Archive @Filenames
  3945.  
  3946.       Keywords  :    MVunpack [command]
  3947.                      OS2MVunpack [command]
  3948.  
  3949.            Examples  :    MVunpack rar x -r -y -o- -std -c- @Archive
  3950.                           @Filenames
  3951.                           OS2MVunpack rar x -r -y -o- -std -c- @Archive
  3952.                           @Filenames
  3953.  
  3954.  
  3955.       Example archiver commands
  3956.       -------------------------
  3957.  
  3958.       Here follows a list of archiver commands which can be used in
  3959.       PalmScan. Please note that this list is not complete. It contains
  3960.       only those commands that have been tested with PalmScan. The Test
  3961.       commands have intentionally been left out, while those should not be
  3962.       used by unexperienced users.
  3963.  
  3964.  
  3965.       Archiver ARC
  3966.       Pack pkarc a @Archive @Filenames
  3967.       OS2pack arc a @Archive @Filenames
  3968.       Unpack pak e /wa @Archive @Filenames
  3969.       OS2unpack arc xo @Archive @Filenames
  3970.       Header pkarc x<@Path\@Filename @Archive
  3971.  
  3972.       Archiver ZIP
  3973.       Pack pkzip -ex -r -p @Archive @Filenames
  3974.       OS2pack zip -k -r -9 -S @Archive @Filenames
  3975.       Unpack pkunzip -o -d @Archive @Filenames
  3976.       OS2unpack unzip -o @Archive @Filenames
  3977.       Header pkzip -z<@Path\@Filename @Archive
  3978.       OS2header zip -z<@Path\@Filename @Archive
  3979.  
  3980.       Archiver LZH
  3981.       Pack lha a /rxpat @Archive @Filenames
  3982.       Unpack lha x /c @Archive @Filenames
  3983.  
  3984.       Archiver ZOO
  3985.       Pack zoo aPh @Archive @Filenames
  3986.       Unpack zoo eO// @Archive @Filenames
  3987.       Header zoo cA<@Path\@Filename @Archive
  3988.  
  3989.       Archiver SQZ
  3990.       Pack sqz a /p3 /s @Archive @Filenames
  3991.       Unpack sqz x -o1 @Archive @Filenames
  3992.  
  3993.       Archiver HYP
  3994.       Pack hyper -a @Archive @Filenames
  3995.       Unpack hyper -xo @Archive @Filenames
  3996.  
  3997.                                       - 64 -
  3998.       PalmScan v2.01                                             User guide
  3999.       ---------------------------------------------------------------------
  4000.  
  4001.       Archiver ARJ
  4002.       Pack arj a -r -y @Archive @Filenames
  4003.       Unpack arj x -y @Archive @Filenames
  4004.       OS2unpack unarj X @Archive @Filenames
  4005.       MVpack arj a -r -y -v@Size @Archive @Filenames
  4006.       MVunpack arj x -y -v @Archive @Filenames
  4007.       Header arj c -z@Path\@Filename @Archive
  4008.  
  4009.       Archiver HAP
  4010.       Pack hap a @Archive @Filenames
  4011.       Unpack pah e @Archive @Filenames
  4012.  
  4013.       Archiver PAK
  4014.       Pack pak a /i @Archive @Filenames
  4015.       Unpack pak e /wa @Archive @Filenames
  4016.       Header pak h<@Path\@Filename @Archive
  4017.  
  4018.       Archiver UC2
  4019.       Pack uc a -s -tst -f -b @Archive @Filenames
  4020.       Unpack uc e -s -f !ban=off @Archive @Filenames
  4021.       Header uc a -tt -f -b @Archive @Path\@Filename
  4022.  
  4023.       Archiver RAR
  4024.       Pack rar a -r -y -o- -std -m5 @Archive @Filenames
  4025.       OS2pack rar a -r -y -o- -std -m5 @Archive @Filenames
  4026.       Unpack rar x -r -y -o- -std -c- @Archive @Filenames
  4027.       OS2unpack rar x -r -y -o- -std -c- @Archive @Filenames
  4028.       MVpack rar a -r -y -o- -std -m5 -v@Size @Archive @Filenames
  4029.       OS2MVpack rar a -r -y -o- -std -m5 -v@Size @Archive @Filenames
  4030.       MVunpack rar x -r -y -o- -std -c- @Archive @Filenames
  4031.       OS2MVunpack rar x -r -y -o- -std -c- @Archive @Filenames
  4032.       Header rar c -y -std @Archive =@Path\@Filename
  4033.       OS2header rar c -y -std @Archive =@Path\@Filename
  4034.  
  4035.       Archiver DWC
  4036.       Pack dwc a @Archive @Filenames
  4037.       Unpack dwc e @Archive @Filenames
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.                                       - 65 -
  4061.       PalmScan v2.01                                             User guide
  4062.       ---------------------------------------------------------------------
  4063.  
  4064.       3.5.2  Archive Protection
  4065.       -------------------------
  4066.  
  4067.       UC2 protection
  4068.       --------------
  4069.  
  4070.       When an archive has been converted to UC2, PalmScan can add all
  4071.       available UC2 protections to it. By default, no protection will be
  4072.       added.
  4073.  
  4074.       Keyword   :    UC2protection <BasicUpdates> <Delete> <Add> <Optimize>
  4075.                      <Unprotect> <ReviseComment>
  4076.  
  4077.            <BasicUpdates>      Disable basic updates on processed archives.
  4078.            <Delete>            Disable deleting files in processed
  4079.                                archives.
  4080.            <Add>               Disable adding files to processed archives.
  4081.            <Optimize>          Disable optimize on processed archives.
  4082.            <Unprotect>         Disable unprotect on processed archives.
  4083.            <ReviseComment>     Disable comment revising on processed
  4084.                                archives.
  4085.  
  4086.            Example   :    UC2protection Add Unprotect ReviseComment
  4087.  
  4088.  
  4089.       RAR lock
  4090.       --------
  4091.  
  4092.       When an archive has been converted to RAR, PalmScan can add a lock to
  4093.       it. By default, RAR archives will not be locked.
  4094.  
  4095.       Keywords  :    RARlock [command]
  4096.                      OS2RARlock [command]
  4097.  
  4098.            [command]      To enable RAR archive locking, the command to
  4099.                           lock a RAR archive must be configured here. When
  4100.                           you are a registered RAR user, an authenticity
  4101.                           validation can also be added here.
  4102.  
  4103.            Example   :    RARlock RAR_k_-av
  4104.  
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.                                       - 66 -
  4124.       PalmScan v2.01                                             User guide
  4125.       ---------------------------------------------------------------------
  4126.  
  4127.       3.6  Virus scan
  4128.       ---------------
  4129.  
  4130.       3.6.1  Files to scan
  4131.       --------------------
  4132.  
  4133.       In this list, file specifications of files which should be scanned
  4134.       for viruses, can be entered. When one or more files which comply to
  4135.       the file specifications configured here, PalmScan will start the
  4136.       virus scan.
  4137.  
  4138.       Examples  :    *.EXE
  4139.                      *.COM
  4140.                      *.OV?
  4141.                      *.DLL
  4142.  
  4143.       Keyword   :    VirusScan <filespec> <filespecs>
  4144.  
  4145.            <filespec>     This can be any valid DOS or OS/2 file
  4146.                           specification.
  4147.                           When you give a file specification, PalmScan will
  4148.                           only execute the virus scanner(s) when one or
  4149.                           more file(s) have been found that meet the
  4150.                           requirements of these file specifications.
  4151.                           When no file specifications are given, and the
  4152.                           VirusScan keyword is used, PalmScan will always
  4153.                           execute the virus scanner(s). In PSetup, there
  4154.                           must always be at least one file specification,
  4155.                           e.g. *.*.
  4156.  
  4157.            Example   :    VirusScan *.EXE *.COM *.OVR *.OVL
  4158.  
  4159.  
  4160.       3.6.2  Virus scanners
  4161.       ---------------------
  4162.  
  4163.       Here up to 20 virus scanners can be configured. There are two
  4164.       keywords available for this: Scanner and OS2scanner. The DOS version
  4165.       always uses the Scanner keyword, the OS/2 uses the OS2scanner keyword
  4166.       and, when no OS/2 scanner is configured with the same name, the
  4167.       Scanner keyword.
  4168.  
  4169.       Scanner name
  4170.       ------------
  4171.  
  4172.       This is the name of the virus scanner.
  4173.  
  4174.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4175.                      <filespecs>>>
  4176.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4177.                      <filespecs>>>
  4178.  
  4179.            For more information about the Scanner keyword, please read the
  4180.            section about that keyword.
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.                                       - 67 -
  4187.       PalmScan v2.01                                             User guide
  4188.       ---------------------------------------------------------------------
  4189.  
  4190.       Command
  4191.       -------
  4192.  
  4193.       This is the command for the virus scanner to be executed. The
  4194.       path/filename(s) of the file(s) to be scanned will NOT be
  4195.       automatically added to the commandline. There are some keywords which
  4196.       will be replaced with the correct string by PalmScan:
  4197.  
  4198.       @PATH     The directory that should be scanned (without trailing
  4199.                 backlash).
  4200.  
  4201.       @FILENAME The filename of the file(s) to be scanned.
  4202.  
  4203.       @FULL     The path and filename of the file(s) to be scanned.
  4204.                 (@FULL = @PATH\@FILENAME)
  4205.  
  4206.       @SPECIAL  This meta-command is a special one; it will act like @FULL
  4207.                 when a specific file should be scanned, and  like @PATH
  4208.                 when all files in a directory should be scanned.
  4209.  
  4210.       @REPORT   When a virus has been found, PalmScan will include the
  4211.                 report created by the virus scanner(s) which found one or
  4212.                 more virus(es) in the message which is posted to the system
  4213.                 operator. To use this feature, @REPORT must be included on
  4214.                 the virus scanner commandline, along with the appropriate
  4215.                 command for that program to create the report.
  4216.                 PalmScan will replace @REPORT with a filename for the
  4217.                 report.
  4218.  
  4219.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4220.                      <filespecs>>>
  4221.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4222.                      <filespecs>>>
  4223.  
  4224.            For more information about the Scanner keyword, please read the
  4225.            section about that keyword.
  4226.  
  4227.  
  4228.       Low Errorlevel
  4229.       --------------
  4230.  
  4231.       This is the lowest errorlevel the virus scanner will return when a
  4232.       virus has been found.
  4233.  
  4234.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4235.                      <filespecs>>>
  4236.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4237.                      <filespecs>>>
  4238.  
  4239.            For more information about the Scanner keyword, please read the
  4240.            section about that keyword.
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.                                       - 68 -
  4250.       PalmScan v2.01                                             User guide
  4251.       ---------------------------------------------------------------------
  4252.  
  4253.       High Errorlevel
  4254.       ---------------
  4255.  
  4256.       This is the highest errorlevel the virus scanner will return when a
  4257.       virus has been found. When it is not set, PalmScan assumes the virus
  4258.       scanner will only return the low errorlevel when a virus has been
  4259.       found.
  4260.  
  4261.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4262.                      <filespecs>>>
  4263.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4264.                      <filespecs>>>
  4265.  
  4266.            For more information about the Scanner keyword, please read the
  4267.            section about that keyword.
  4268.  
  4269.  
  4270.       Other Errorlevel
  4271.       ----------------
  4272.  
  4273.       This is the errorlevel that the virus scanner will return when
  4274.       nothing is wrong. Most virus scanners return errorlevel 0 when there
  4275.       are no problems, but there are some scanners which return another
  4276.       errorlevel just because there are no executables found. With this
  4277.       option you can make PalmScan simply ignore that errorlevel.
  4278.  
  4279.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4280.                      <filespecs>>>
  4281.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4282.                      <filespecs>>>
  4283.  
  4284.            For more information about the Scanner keyword, please read the
  4285.            section about that keyword.
  4286.  
  4287.  
  4288.       File specifications
  4289.       -------------------
  4290.  
  4291.       Up to 5 file specifications can optionally be given. First, PalmScan
  4292.       will check the global file specifications (configured in the files to
  4293.       scan section). When there are files which comply with those, the
  4294.       virus scanning will start. Before executing each virus scanner,
  4295.       PalmScan will check the file specifications for those virus scanners,
  4296.       and only execute them when there are no file specifications
  4297.       configured at that virus scanner or when there are files which comply
  4298.       with those specifications.
  4299.  
  4300.       Keywords  :    Scanner [name] [command] [lll] <[hhh] <[nnn]
  4301.                      <filespecs>>>
  4302.                      OS2scanner [name] [command] [lll] <[hhh] <[nnn]
  4303.                      <filespecs>>>
  4304.  
  4305.            For more information about the Scanner keyword, please read the
  4306.            section about that keyword.
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.                                       - 69 -
  4313.       PalmScan v2.01                                             User guide
  4314.       ---------------------------------------------------------------------
  4315.  
  4316.       Scanner configuration keyword
  4317.       -----------------------------
  4318.  
  4319.       Keyword : Scanner [name] [command] [lll] <[hhh] <[nnn] <filespecs>>>
  4320.  
  4321.            [name]    The name of the virus scanner.
  4322.  
  4323.            [command] The command to start this virus scanner.
  4324.  
  4325.            [lll]     The lowest errorlevel the virus scanner returns when a
  4326.                      virus has been found.
  4327.  
  4328.            <hhh>     The highest errorlevel the virus scanner returns when
  4329.                      a virus has been found.
  4330.  
  4331.            <nnn>     The errorlevel that the virus scanner returns when
  4332.                      nothing is wrong.
  4333.  
  4334.            <filespecs>    Up to 5 scanner-specific file specifications.
  4335.  
  4336.            Examples :     Scanner McAfee_Scan
  4337.                           SCAN_/NOEXPIRE_/NOMEM_/REPORT_@REPORT_/SUB_@FULL
  4338.                           13 13 14
  4339.  
  4340.                           OS2scanner McAfee_Scan
  4341.                           OS2SCAN_/NOEXPIRE_/REPORT_@REPORT_/SUB_@FULL 13
  4342.                           13 14
  4343.  
  4344.                           Scanner ThunderByte_Scan
  4345.                           TBSCAN_AF_NB_NM_BA_IN_NA_OLD_LOG_LOGNAME=@REPORT_
  4346.                           @SPECIAL 2 127 1
  4347.  
  4348.                           Scanner F-Prot
  4349.                           F-PROT_/ALL_/COMMAND_/NOMEM_/OLD_/NOBOOT_/REPORT=
  4350.                           @REPORT_ @FULL 3 3 0
  4351.  
  4352.                           Scanner AVScan AVSCAN_/NM_/NC_/Q_/R_/S_@FULL 100
  4353.                           255 0 *.exe *.com
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.                                       - 70 -
  4376.       PalmScan v2.01                                             User guide
  4377.       ---------------------------------------------------------------------
  4378.  
  4379.       3.6.3  Options
  4380.       --------------
  4381.  
  4382.       Complete scan
  4383.       -------------
  4384.  
  4385.       Normally, PalmScan will not process embedded archives when a virus
  4386.       has already been found. This feature enables the processing of those
  4387.       embedded archives, which is especially useful when using the message
  4388.       system. PalmScan will then create a complete overview of all infected
  4389.       files in an archive.
  4390.  
  4391.       Example   :    X
  4392.  
  4393.       Keyword   :    CompleteScan
  4394.  
  4395.            Example   :    CompleteScan
  4396.  
  4397.  
  4398.       Fast scan
  4399.       ---------
  4400.  
  4401.       PalmScan can scan for viruses in the main archive and in all embedded
  4402.       archives in one run. When this feature is used, PalmScan will unpack
  4403.       all embedded archives right after the main archive has been unpacked.
  4404.       The virus scan is done at the point where it would normally scan for
  4405.       viruses in the main archive. All other embedded archive processing is
  4406.       done the same as without this feature.
  4407.       For the fast scan feature to work properly, your virus scanners must
  4408.       be configured to scan the current directory and all subdirectories.
  4409.       (The example virus scanner commands will do this properly).
  4410.       When this feature is not used, PalmScan will scan each embedded
  4411.       archive separately.
  4412.  
  4413.       Example   :    X
  4414.  
  4415.       Keyword   :    FastScan
  4416.  
  4417.            Example   :    FastScan
  4418.  
  4419.       Note      :    This is a bonus feature, which is available in the
  4420.                      registered version only.
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.                                       - 71 -
  4439.       PalmScan v2.01                                             User guide
  4440.       ---------------------------------------------------------------------
  4441.  
  4442.       3.7  Hacked Files
  4443.       -----------------
  4444.  
  4445.       In this list, file-specifications of files which are dangerous or
  4446.       unwanted can be configured.
  4447.       Files which are found in this list, will be moved to the hacked files
  4448.       directory, or, when no hacked files directory is configured, PalmScan
  4449.       will exit with an errorlevel.
  4450.       For this feature to work properly, a hacked files list must be
  4451.       configured in the files lists section.
  4452.  
  4453.  
  4454.       Example   :    PKZIP201.*
  4455.  
  4456.  
  4457.       3.8  Skip Files
  4458.       ---------------
  4459.  
  4460.       In this list, file-specifications of files which should not be
  4461.       processed can be configured. Full path names can also be included in
  4462.       these file specifications.
  4463.       For this feature to work properly, a skip files list must be
  4464.       configured in the files lists section.
  4465.  
  4466.       Examples  :    BIMODEM.LOG
  4467.                      D:\FILES\SKIP\*.*
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.                                       - 72 -
  4502.       PalmScan v2.01                                             User guide
  4503.       ---------------------------------------------------------------------
  4504.  
  4505.       3.9  Pack Unpacked
  4506.       ------------------
  4507.  
  4508.       File specifications
  4509.       -------------------
  4510.  
  4511.       In this list, file-specifications of unpacked files which should be
  4512.       packed can be configured. All files which comply to one or more of
  4513.       the configured file-specifications, and are not archives, will be
  4514.       archived with the archiver configured at the archive conversion
  4515.       feature.
  4516.       For this feature to work properly, a pack unpacked files list must be
  4517.       configured in the files lists section.
  4518.  
  4519.       Example   :    *.TXT
  4520.  
  4521.  
  4522.       Minimum size
  4523.       ------------
  4524.  
  4525.       The minimum size (in bytes) for unpacked files which should be
  4526.       packed, can be configured with this option. This option is available
  4527.       so very small files will not be packed, which would otherwise cause
  4528.       an archive which is larger than the original file.
  4529.       Another use can be that files which fit into one allocation block (on
  4530.       FAT partitions, this often is 8192 bytes) will not get packed. It
  4531.       might result in a smaller file when a file which is smaller than one
  4532.       allocation block is packed, but wouldn't result in reduction in disk
  4533.       space usage.
  4534.  
  4535.       Example   :    2048
  4536.  
  4537.       Keyword   :    PackUnpackedSize [size]
  4538.  
  4539.            [size]         This is the minimum size in bytes.
  4540.  
  4541.            Example   :    PackUnpackedSize 2048
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.  
  4563.  
  4564.                                       - 73 -
  4565.       PalmScan v2.01                                             User guide
  4566.       ---------------------------------------------------------------------
  4567.  
  4568.       3.10 Remove Files
  4569.       -----------------
  4570.  
  4571.       Many archives contain some files which have no relation with the
  4572.       actual archive, like advertisements added at bulletin boards. This
  4573.       can eventually take up a large part of your available disk space.
  4574.       PalmScan can remove these files from the archives.
  4575.       In this list, file-specifications of files which should be removed
  4576.       from archives, can be configured. Optional for each file-
  4577.       specification, a filesize and CRC-32 can be configured. When a
  4578.       filesize and/or CRC-32 is configured for a file-specification, only
  4579.       those files which comply to the file-specification and have the
  4580.       filesize and/or CRC-32 as configured for this file-specification,
  4581.       will be removed. This can be useful for removing advertisements which
  4582.       have another filename every time, but have the same contents (thus
  4583.       have the same filesize and CRC-32). It can also be used to remove
  4584.       empty files by configuring the filesize to 0.
  4585.       For this feature to work properly, a remove files list must be
  4586.       configured in the files lists section.
  4587.  
  4588.       Examples  :    OASISBBS.ADV
  4589.                      CALL.* /SIZE=248 /CRC=23a86bf9
  4590.                      *.* /SIZE=0
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.                                       - 74 -
  4628.       PalmScan v2.01                                             User guide
  4629.       ---------------------------------------------------------------------
  4630.  
  4631.       3.11 Add Files
  4632.       --------------
  4633.  
  4634.       Just like PalmScan can remove files from archives, it can also add
  4635.       files to them. This can be used to add an advertisement for your
  4636.       bulletin board, or whatever you want added to the archives.
  4637.       Only full path and filenames can be configured in this list. PalmScan
  4638.       will add these files in the home directory of the main archive.
  4639.       For this feature to work properly, an add files list must be
  4640.       configured in the files lists section.
  4641.  
  4642.       Example   :    C:\PALMSCAN\OASISBBS.ADV
  4643.  
  4644.  
  4645.       Add CRC file list
  4646.       -----------------
  4647.  
  4648.       PalmScan can create a list with all filenames, sizes, dates and
  4649.       CRC-32's of all files in the archive. This file will look like this:
  4650.  
  4651.            CRC-32 files list for : ARCHIVE.EXT
  4652.            Created by PalmScan v2.01 on BBS name
  4653.  
  4654.            File         Size     Date       Time  CRC-32
  4655.            -----------------------------------------------
  4656.            FILENAME.EXT XXXXXXXX XX-XX-XXXX XX:XX XXXXXXXX
  4657.            -----------------------------------------------
  4658.  
  4659.       The filename of the list will be the same as the archive filename,
  4660.       with extension .CRC.
  4661.  
  4662.       Example   :    Only Main Archive
  4663.  
  4664.       Keyword   :    AddCRCfile <OnlyMainArchive>
  4665.  
  4666.            <OnlyMainArchive>   When this switch is specified, PalmScan will
  4667.                                only create a CRC-32 list in the main
  4668.                                archive. Embedded archives will not get a
  4669.                                CRC-32 list.
  4670.  
  4671.            Example   :    AddCRCfile OnlyMainArchive
  4672.  
  4673.       Note      :    The BBS name will only be added when using the
  4674.                      registered version of PalmScan.
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.  
  4690.                                       - 75 -
  4691.       PalmScan v2.01                                             User guide
  4692.       ---------------------------------------------------------------------
  4693.  
  4694.       3.12 GIF settings
  4695.       -----------------
  4696.  
  4697.       Add GIF specifications to descriptions
  4698.       --------------------------------------
  4699.  
  4700.       PalmScan will add GIF/PNG (resolution and colors) and JFIF/JPEG
  4701.       (resolution and color/gray) specifications to descriptions when this
  4702.       keyword is used. Optional are the characters that are used in the
  4703.       descriptions, but when specifying one of them, both others must be
  4704.       specified too. By default, these characters are used : ( x )
  4705.       When used with FILES.BBS or a file-database, PalmScan will first
  4706.       check if the specifications already exist in the description, and
  4707.       only add them when they do not already exist.
  4708.  
  4709.       Example   :    X
  4710.  
  4711.       Keyword   :    GIFspecs <[left bracket] ['by' character] [right
  4712.                      bracket]>
  4713.  
  4714.            Example   :    GIFspecs < * >
  4715.  
  4716.  
  4717.  
  4718.  
  4719.  
  4720.  
  4721.  
  4722.  
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.                                       - 76 -
  4754.       PalmScan v2.01                                             User guide
  4755.       ---------------------------------------------------------------------
  4756.  
  4757.       GIF pack
  4758.       --------
  4759.  
  4760.       To convert GIF pictures to another format, this feature can be used.
  4761.  
  4762.       The title is only used to display to what format the file is being
  4763.       converted, but must be configured when using this feature.
  4764.  
  4765.       The command that should be executed to convert the GIF picture must
  4766.       also be configured when using this feature.
  4767.  
  4768.       PalmScan will by default add the original filename and extension to
  4769.       the GIFpack commandline. This is configurable with these options:
  4770.  
  4771.       @FILENAME      Will be replaced by the original filename.
  4772.  
  4773.       @EXT           Will be replaced by the original extension.
  4774.  
  4775.       If you do not want embedded graphics files to be converted, 'Do NOT
  4776.       convert embedded graphics files' should be selected. Some archives
  4777.       contain graphics files which are used by the program(s) inside the
  4778.       archive. Converting those graphics files would result in the programs
  4779.       not finding the graphics files when they are needed.
  4780.  
  4781.       Programs which replace the original file (e.g. GIFlite) can be used
  4782.       with this feature.
  4783.  
  4784.       Example   :    X
  4785.                      JFIF
  4786.                      CJPEG.EXE @FILENAME.@EXT @FILENAME.JPG
  4787.  
  4788.       Keyword   :    GIFpack [title] [command] <NoEmbedded>
  4789.  
  4790.            [title]        The title of the configured GIF pack utility.
  4791.  
  4792.            [command]      The command that should be executed to pack the
  4793.                           GIF file.
  4794.  
  4795.            <NoEmbedded>   Do not convert embedded graphics files.
  4796.  
  4797.            Example   :    GIFpack JFIF CJPEG.EXE @FILENAME.@EXT
  4798.                           @FILENAME.JPG
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.                                       - 77 -
  4817.       PalmScan v2.01                                             User guide
  4818.       ---------------------------------------------------------------------
  4819.  
  4820.       JFIF unpack
  4821.       -----------
  4822.  
  4823.       PalmScan will use this command to convert JFIF files to GIF. JFIF
  4824.       files are standard JFIF/JPEG files, which can be created by CJPEG and
  4825.       some other graphics conversion utilities.
  4826.  
  4827.       Example   :    DJPEG.EXE
  4828.  
  4829.       Keyword   :    JFIFunpack [command]
  4830.  
  4831.            [command]      This is the command that should be executed to
  4832.                           convert the JFIF file.
  4833.  
  4834.            Example   :    JFIFunpack DJPEG.EXE
  4835.  
  4836.  
  4837.       JPEG unpack
  4838.       -----------
  4839.  
  4840.       This is almost the same as JFIF unpack, with the difference that JPEG
  4841.       files are files which are incompatible with standard JFIF/JPEG files.
  4842.       Files created by (older versions of) GIF2JPG are such JPEG files.
  4843.       When this command is not configured, and JFIF unpack is configured,
  4844.       PalmScan will try to convert JPEG files to GIF using the command
  4845.       configured at JFIF unpack.
  4846.  
  4847.       Example   :    JPG2GIF.EXE
  4848.  
  4849.       Keyword   :    JPEGunpack [command]
  4850.  
  4851.            [command]      This is the command that should be executed to
  4852.                           convert the JPEG file.
  4853.  
  4854.            Example   :    JPEGunpack JPG2GIF.EXE
  4855.  
  4856.  
  4857.       GIFblast unpack
  4858.       ---------------
  4859.  
  4860.       PalmScan will use this command to convert GIFblast files to GIF.
  4861.  
  4862.       Example   :    GIFBLAST.EXE -D
  4863.  
  4864.       Keyword   :    GIFBLASTunpack [command]
  4865.  
  4866.            [command]      This is the command that should be executed to
  4867.                           convert the GIFblast file.
  4868.  
  4869.            Example   :    GIFBLASTunpack GIFBLAST.EXE_-D
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.                                       - 78 -
  4880.       PalmScan v2.01                                             User guide
  4881.       ---------------------------------------------------------------------
  4882.  
  4883.       Repack JFIF files
  4884.       -----------------
  4885.  
  4886.       When this option is selected, JFIF files will first be converted to
  4887.       GIF, and then converted using the command configured with the GIFpack
  4888.       keyword.
  4889.  
  4890.       Example   :    X
  4891.  
  4892.       Keyword   :    JFIFrepack
  4893.  
  4894.            Example   :    JFIFrepack
  4895.  
  4896.  
  4897.       Repack JPEG files
  4898.       -----------------
  4899.  
  4900.       hen this option is selected, JPEG files will first be converted to
  4901.       GIF, and then converted using the command configured with the GIFpack
  4902.       keyword.
  4903.  
  4904.       Example   :    X
  4905.  
  4906.       Keyword   :    JPEGrepack
  4907.  
  4908.            Example   :    JPEGrepack
  4909.  
  4910.  
  4911.       Repack GIFblast files
  4912.       ---------------------
  4913.  
  4914.       When this option is selected, GIFblast files will first be converted
  4915.       to GIF, and then converted using the command configured with the
  4916.       GIFpack keyword.
  4917.  
  4918.       Example   :    X
  4919.  
  4920.       Keyword   :    GIFBLASTrepack
  4921.  
  4922.            Example   :    GIFBLASTrepack
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.                                       - 79 -
  4943.       PalmScan v2.01                                             User guide
  4944.       ---------------------------------------------------------------------
  4945.  
  4946.       Minimum resolution
  4947.       ------------------
  4948.  
  4949.       PalmScan can reject GIF, PNG, JFIF, JPEG and GIFblast files which
  4950.       have a resolution which is too low. When either one of the resolution
  4951.       values is lower than the configured value, PalmScan will move the
  4952.       file to the directory configured as bad GIF directory. When no bad
  4953.       GIF directory is configured, PalmScan will exit with errorlevel 205.
  4954.       When a message area is configured, a message to the system operator
  4955.       will also be posted.
  4956.  
  4957.       Example   :    320x200x256
  4958.  
  4959.       Keyword   :    MinimumResolution [horizontal]x[vertical]x[colors]
  4960.  
  4961.            [horizontal]   The minimum horizontal resolution (width).
  4962.  
  4963.            [vertical]     The minimum vertical resolution (height).
  4964.  
  4965.            [colors]       The minumum number of colors.
  4966.  
  4967.            Example   :    MinimumResolution 320x200x256
  4968.  
  4969.  
  4970.       GIF test command / failures
  4971.       ---------------------------
  4972.  
  4973.       PalmScan can use an external GIF testing program to test all GIF
  4974.       files. Up to ten errorlevels can be configured, which will cause
  4975.       PalmScan to treat the file as bad GIF file.
  4976.  
  4977.       Example   :    GIFTEST.EXE /M:320x200x256
  4978.                      1    20   25
  4979.  
  4980.       Keyword   :    GIFtest [command] <errorlevels>
  4981.  
  4982.            [command]      The command to execute to test GIF files.
  4983.  
  4984.            <errorlevels>  Up to 10 errorlevels can be configured. When the
  4985.                           result from [command] is one of the configured
  4986.                           errorlevels, PalmScan will move the file to the
  4987.                           BadGifPath, or exit with errorlevel 205 when no
  4988.                           BadGifPath is configured. When a message area is
  4989.                           configured, a message to the system operator will
  4990.                           also be posted.
  4991.  
  4992.            Example   :    GIFtest GIFTEST.EXE_/M:320x200x256 1 20 25
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.                                       - 80 -
  5006.       PalmScan v2.01                                             User guide
  5007.       ---------------------------------------------------------------------
  5008.  
  5009.       3.13 Old files
  5010.       ---------------
  5011.  
  5012.       PalmScan can check for files which are too old. Either the maximum
  5013.       age in days or a date can be used for this check.
  5014.       The date that will be checked can also be selected. Original means
  5015.       PalmScan will check the original date of the archive. Oldest means
  5016.       PalmScan will check the oldest date of all files in the archive.
  5017.       Latest means PalmScan will check the latest date of all files in the
  5018.       archive.
  5019.       PalmScan will check for old files right after embedded archives have
  5020.       been processed. When an old file has been encountered, it will be
  5021.       moved to the directory configured as old files directory. When no old
  5022.       files directory is configured, PalmScan will exit with errorlevel
  5023.       204. When a message area is configured, a message to the system
  5024.       operator will also be posted.
  5025.  
  5026.       Example   :    01-01-1995
  5027.  
  5028.       Keyword   :    OldFiles [[-days]|[dd-mm-yyyy]]
  5029.                      <Original|Latest|Oldest>
  5030.  
  5031.            [-days]        The maximum age of a file, in days.
  5032.  
  5033.            [dd-mm-yyy]    The oldest allowed date of a file, in
  5034.                           date-month-year format.
  5035.  
  5036.            <Original>     PalmScan will use the original archive's date.
  5037.  
  5038.            <Latest>       Use the latest date of the files inside the
  5039.                           archive.
  5040.  
  5041.            <Oldest>       Use the oldest date of the files inside the
  5042.                           archive.
  5043.  
  5044.            Example   :    OldFiles -90 Latest
  5045.  
  5046.  
  5047.  
  5048.  
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  
  5055.  
  5056.  
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.  
  5065.  
  5066.  
  5067.  
  5068.                                       - 81 -
  5069.       PalmScan v2.01                                             User guide
  5070.       ---------------------------------------------------------------------
  5071.  
  5072.       3.14 Include Configurations
  5073.       ----------------------------
  5074.  
  5075.       In this list, configuration files which should be included in the
  5076.       configuration, can be configured. PSetup will not read the included
  5077.       configuration files (else those would be combined to one
  5078.       configuration file when saving it).
  5079.       PalmScan will read included configuration files before reading the
  5080.       entries in the original configuration file, thus options in the
  5081.       original configuration file can override options in included
  5082.       configuration files.
  5083.  
  5084.       Example   :    C:\PALMSCAN\ARCHIVER.CFG
  5085.  
  5086.       Keyword   :    Include [configuration-filename]
  5087.  
  5088.            [configuration-filename] This is the full path and filename of
  5089.                                     the configuration file to be included.
  5090.  
  5091.            Example   :    Include C:\PALMSCAN\ARCHIVER.CFG
  5092.  
  5093.  
  5094.  
  5095.  
  5096.  
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103.  
  5104.  
  5105.  
  5106.  
  5107.  
  5108.  
  5109.  
  5110.  
  5111.  
  5112.  
  5113.  
  5114.  
  5115.  
  5116.  
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.                                       - 82 -
  5132.       PalmScan v2.01                                             User guide
  5133.       ---------------------------------------------------------------------
  5134.  
  5135.       4  Registration
  5136.       ---------------
  5137.  
  5138.       After you have evaluated PalmScan for the period of one month, you
  5139.       must either register or discontinue using PalmScan. PalmScan is
  5140.       released as 'try before you buy', so please buy it if you like it.
  5141.  
  5142.       As long as you don't register, PalmScan will remind you that you have
  5143.       not registered when PalmScan is started up.
  5144.  
  5145.       To register, fill out the registration form and send it to the
  5146.       registration site.
  5147.  
  5148.       For information about prices and registration sites, see the
  5149.       registration forms included in this package.
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.  
  5193.  
  5194.                                       - 83 -
  5195.       PalmScan v2.01                                             User guide
  5196.       ---------------------------------------------------------------------
  5197.  
  5198.       5  Credits
  5199.       ----------
  5200.  
  5201.       Thanks to all registered users and beta testers, for registering and
  5202.       testing this software, and for all suggestions I got from you.
  5203.  
  5204.       All brand and product names are copyrighted (C) by and/or trademarks
  5205.       (TM) or registered trademarks (R) of their respective holders:
  5206.  
  5207.       4DOS                          JP Software Inc.
  5208.       Allfix                        Harald Harms
  5209.       ARJ                           Robert K. Jung
  5210.       AVScan                        H+BEDV Datentechnik GmbH
  5211.       CJPEG, DJPEG                  Thomas G. Lane
  5212.       Concord                       Pasi Talliniemi
  5213.       Ezycom                        Peter Davies
  5214.       F-Prot                        Frisk Software International
  5215.       Fido                          Tom Jennings and Fido Software
  5216.       FileDoor                      Robert W. van Hoeven
  5217.       GIF                           CompuServe Incorporated
  5218.       GIF2JPG, JPG2GIF              Handmade Software, Inc.
  5219.       GIFblast                      Isaac Dimitrovsky
  5220.       GIFtest                       Max Bernard and Dave Navarro, Jr.
  5221.       HAP, PAH                      Harald Feldmann
  5222.       Hudson messagebase            Adam Hudson
  5223.       Hyper                         P. Sawatzki and K.P. Nischke
  5224.       IBM, OS/2, PC-DOS             International Business Machines Corp.
  5225.       JAM                           Joaquim Homrighausen, Andrew Milner,
  5226.                                     Mats Birch, Mats Wallin
  5227.       LHA                           Haruyasu Yoskizaki
  5228.       Microsoft, MS-DOS             Microsoft Corporation
  5229.       PAK                           NoGate Consulting
  5230.       PKARC, PKZIP                  PKWARE, Inc.
  5231.       ProBoard                      Philippe Leybaert
  5232.       QuickBBS                      Pegasus Software
  5233.       RAFT                          Chris Buijs
  5234.       RAR                           Eugene Roshal
  5235.       RemoteAccess                  Wantree Development and Andrew Milner
  5236.       SQZ                           J.I. Hammarsberg
  5237.       SuperBBS                      Aki Antman and Risto Virkkala
  5238.       TBScan                        Thunderbyte BV
  5239.       UltraCompressor II, UC2       Ad Infinitum Programs
  5240.       ViruScan                      McAfee Associates
  5241.       ZOO                           Rahul Dhesi
  5242.  
  5243.  
  5244.  
  5245.  
  5246.  
  5247.  
  5248.  
  5249.  
  5250.  
  5251.  
  5252.  
  5253.  
  5254.  
  5255.  
  5256.  
  5257.                                       - 84 -
  5258.       PalmScan v2.01                                             User guide
  5259.       ---------------------------------------------------------------------
  5260.  
  5261.       I  Index
  5262.  
  5263.  
  5264.       /All  . . . . . . . . . . . .  19     Header  . . . . . . . . . . .  62
  5265.       /AnyArea  . . . . . . . . . .  19     Include . . . . . . . . . . .  82
  5266.       /C[configuration-filename]  .  20     IndentSpaces  . . . . . . . .  41
  5267.       /Debug  . . . . . . . . . . .  23     InfectedPath  . . . . . . . .  30
  5268.       /D[dorinfo-filename]  . . . .  20     JFIFrepack  . . . . . . . . .  79
  5269.       /FDBmaint<areanr<-areanr>>  .  19     JFIFunpack  . . . . . . . . .  78
  5270.       /Fix<+> . . . . . . . . . . .  20     JPEGrepack  . . . . . . . . .  79
  5271.       /L  . . . . . . . . . . . . .  20     JPEGunpack  . . . . . . . . .  78
  5272.       /Mono . . . . . . . . . . . .  23     LogFile . . . . . . . . . . .  43
  5273.       /Move[Path] . . . . . . . . .  22     MessageArea . . . . . . . . .  37
  5274.       /NoChanges  . . . . . . . . .  21     MinimumResolution . . . . . .  80
  5275.       /NoCls  . . . . . . . . . . .  23     MVpack  . . . . . . . . . . .  63
  5276.       /NoConversion . . . . . . . .  21     MVunpack  . . . . . . . . . .  64
  5277.       /NoFDB  . . . . . . . . . . .  21     NetAddress  . . . . . . . . .  35
  5278.       /NoFilesbbs . . . . . . . . .  21     NoDiskSpaceCheck  . . . . . .  44
  5279.       /NoMove . . . . . . . . . . .  22     NoTitleInHdr  . . . . . . . .  55
  5280.       /NoScan . . . . . . . . . . .  22     OldFiles  . . . . . . . . . .  81
  5281.       /N[node]  . . . . . . . . . .  20     OldPath . . . . . . . . . . .  31
  5282.       /P[priority]  . . . . . . . .  23     Online  . . . . . . . . . . .  42
  5283.       /S  . . . . . . . . . . . . .  22     OnlyNewFiles  . . . . . . . .  45
  5284.       /T[archiver]  . . . . . . . .  21     OS2header . . . . . . . . . .  62
  5285.       /Unlisted . . . . . . . . . .  22     OS2key  . . . . . . . . . . .  27
  5286.       /V[Size]  . . . . . . . . . .  22     OS2MVpack . . . . . . . . . .  63
  5287.       AddCRCfile  . . . . . . . . .  75     OS2MVunpack . . . . . . . . .  64
  5288.       AddFilesList  . . . . . . . .  34     OS2pack . . . . . . . . . . .  61
  5289.       AnsiHeader  . . . . . . . . .  54     OS2RARlock  . . . . . . . . .  66
  5290.       ArchInArch  . . . . . . . . .  46     OS2test . . . . . . . . . . .  63
  5291.       ArchiveConversion . . . . . .  50     OS2unpack . . . . . . . . . .  61
  5292.       ArchiveHeader . . . . . . . .  54     Pack  . . . . . . . . . . . .  61
  5293.       Archiver  . . . . . . . . . .  60     PackUnpackedList  . . . . . .  33
  5294.       BadGifPath  . . . . . . . . .  31     PackUnpackedSize  . . . . . .  73
  5295.       BadPath . . . . . . . . . . .  30     ProcessListedOnly . . . . . .  46
  5296.       BBSname . . . . . . . . . . .  27     ProcessSFX  . . . . . . . . .  51
  5297.       BBSpath . . . . . . . . . . .  39     RARlock . . . . . . . . . . .  66
  5298.       ColorBackground . . . . . . .  29     RedirectOutput  . . . . . . .  28
  5299.       ColorHighlight  . . . . . . .  28     RegKey  . . . . . . . . . . .  27
  5300.       ColorNormal . . . . . . . . .  28     RemoveFilesList . . . . . . .  34
  5301.       CompleteScan  . . . . . . . .  71     Scanner . . . . . . . . . . .  70
  5302.       ConvertAll  . . . . . . . . .  50     ScanSFX . . . . . . . . . . .  53
  5303.       DescribeMod . . . . . . . . .  59     SkipFilesList . . . . . . . .  33
  5304.       DownloadCounter . . . . . . .  41     SubstDrive  . . . . . . . . .  32
  5305.       ExecTimeOut . . . . . . . . .  44     SysopName . . . . . . . . . .  27
  5306.       FastScan  . . . . . . . . . .  71     TempPath  . . . . . . . . . .  30
  5307.       FDB . . . . . . . . . . . . .  38     Test  . . . . . . . . . . . .  63
  5308.       FileID  . . . . . . . . . . .  58     Touch . . . . . . . . . . . .  47
  5309.       FileIDarchiveHdr  . . . . . .  55     UC2protection . . . . . . . .  66
  5310.       FilesBBS  . . . . . . . . . .  40     UC2SealTest . . . . . . . . .  53
  5311.       FilesBBSname  . . . . . . . .  42     UC2SFX  . . . . . . . . . . .  52
  5312.       GIFBLASTrepack  . . . . . . .  79     Unpack  . . . . . . . . . . .  61
  5313.       GIFBLASTunpack  . . . . . . .  78     VirusScan . . . . . . . . . .  67
  5314.       GIFpack . . . . . . . . . . .  77
  5315.       GIFspecs  . . . . . . . . . .  76
  5316.       GIFtest . . . . . . . . . . .  80
  5317.       HackList  . . . . . . . . . .  33
  5318.       HackPath  . . . . . . . . . .  31
  5319.  
  5320.                                       - 85 -